# FirstMcpGldo

**Repository Path**: aaabackup/first-mcp-gldo

## Basic Information

- **Project Name**: FirstMcpGldo
- **Description**: ssshttps://gitee.com/aaabackup/first-mcp-gldo.git
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 黄金行情 MCP 服务

基于 Java + Spring Boot + MCP (Model Context Protocol) 协议的贵金属实时行情查询服务。

## 功能特性

- 通过 MCP 协议对外提供黄金、白银实时行情查询
- 数据来源：gold-api.com（免费、无需 API Key）
- 支持 Streamable HTTP 传输，端点 `/mcp`
- 提供两个 MCP 工具：
  - `get_gold_price`：获取贵金属实时行情
  - `list_supported_metals`：列出支持的金属类型

## 技术栈

- Java 17+
- Spring Boot 3.3.x
- MCP Java SDK 0.11.0（io.modelcontextprotocol.sdk）
- Maven

## 项目结构

```
gold-price-mcp/
├── pom.xml
├── README.md
└── src/
    ├── main/
    │   ├── java/com/example/goldmcp/
    │   │   ├── GoldPriceMcpApplication.java    # Spring Boot 启动类
    │   │   ├── model/
    │   │   │   └── GoldPrice.java               # 行情数据模型
    │   │   ├── service/
    │   │   │   └── GoldPriceService.java        # 行情服务（调用外部API）
    │   │   └── mcp/
    │   │       └── GoldPriceMcpServer.java      # MCP 服务端配置
    │   └── resources/
    │       └── application.properties            # 应用配置
    └── test/
        └── java/com/example/goldmcp/
            ├── GoldPriceServiceTest.java         # 服务层测试
            └── GoldPriceMcpApplicationTests.java # 集成测试
```

## 快速开始

### 编译

```bash
mvn clean compile
```

### 运行测试

```bash
mvn test
```

### 启动服务

```bash
mvn spring-boot:run
```

或打包后运行：

```bash
mvn clean package -DskipTests
java -jar target/gold-price-mcp-1.0.0.jar
```

服务启动后，MCP 端点为：`http://localhost:8080/mcp`

## MCP 工具说明

### 1. get_gold_price

获取贵金属实时行情价格。

**参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| metal | string | 否 | 金属类型：`gold`(黄金)、`silver`(白银)，默认为 `gold` |

**返回示例：**

```json
{
  "symbol": "GC=F",
  "name": "黄金",
  "currency": "USD",
  "unit": "盎司(oz)",
  "price": 4580.8,
  "timestamp": "2026-08-28T06:09:21Z",
  "source": "gold-api.com"
}
```

### 2. list_supported_metals

列出当前服务支持查询的所有贵金属类型。

**参数：** 无

**返回示例：**

```
支持的贵金属类型：

- gold: 黄金 (GC=F)
- silver: 白银 (SI=F)

使用 get_gold_price 工具，传入 metal 参数即可查询对应金属行情。
```

## 配置说明

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| server.port | 8080 | 服务端口 |
| spring.application.name | gold-price-mcp | 应用名称 |

## 注意事项

- 本服务在 Windows 环境下通过 PowerShell 的 `Invoke-RestMethod` 获取外部 API 数据，以解决 Java 原生 TLS 客户端与部分 CDN 的兼容性问题。
- 行情数据来源于 gold-api.com，数据更新频率和准确性取决于该第三方服务。
- 当前仅支持黄金和白银两种贵金属。

## License

MIT