MCP 财务服务器

该项目是一个使用Go构建简单MCP服务器的实际示例。它模拟了金融工具的管理，并通过Alpha Vantage的公共API执行实时股票报价查询。

目标是展示如何构建一个遵循Model Context Protocol (MCP)基本原理的服务器，包括暴露一个端点 /metadata。

功能

• 动态注册财务工具
• 列出所有已注册的工具
• 查看实时股票价格（Alpha Vantage）
• 向客户端代理暴露符合MCP标准的元数据

端点结构

1. 注册财务工具

POST http://localhost:8080/register-financial-tool
Content-Type: application/json

{
  "name": "查询股票",
  "description": "查询实时股票报价",
  "endpoint": "https://www.alphavantage.co/query",
  "service_type": "报价"
}

2. 列出财务工具

GET http://localhost:8080/list-financial-tools
Accept: application/json

3. 查询股票价格（Alpha Vantage）

POST http://localhost:8080/query-stock-price
Content-Type: application/json

{
  "symbol": "AAPL"
}

4. 查询MCP服务器元数据

GET http://localhost:8080/metadata
Accept: application/json

预备条件

• 在Alpha Vantage上创建一个免费账户以生成您的API密钥

如何运行项目

1. 克隆仓库

git clone https://github.com/seuusuario/go-mcp-server-financeiro.git
cd go-mcp-server-financeiro

2. 在项目的根目录下创建一个.env文件：

ALPHA_VANTAGE_API_KEY=你的API密钥

3. 安装依赖

go mod tidy

4. 运行服务器

go run cmd/main.go

服务器将在http://localhost:8080可用。