MCP Server Financeiro

金融 MCP Server

本项目是一个使用 Go 构建简单 MCP Server 的实践示例。
它模拟金融工具的管理，并使用 Alpha Vantage 公共 API 实时查询股票报价。

本项目旨在展示如何构建遵循 Model Context Protocol (MCP) 基本原则的服务器，包括公开 /metadata 端点。

功能

• 动态注册金融工具
• 列出所有已注册的工具
• 实时查询股票价格（Alpha Vantage）
• 按照 MCP 标准向客户端 Agent 公开元数据

端点结构

1. 注册金融工具

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

{
  "name": "Consulta Ações",
  "description": "Consulta cotações de ações em tempo real",
  "endpoint": "https://www.alphavantage.co/query",
  "service_type": "cotacao"
}

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 Server 的元数据

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

前提条件

• 拥有免费的 Alpha Vantage 账户，以获取 API Key

如何运行项目

1. 克隆仓库

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

2. 在项目根目录创建 .env 文件：

ALPHA_VANTAGE_API_KEY=sua_api_key_aqui

3. 安装依赖

go mod tidy

4. 运行服务器

go run cmd/main.go

服务器将在 http://localhost:8080 上运行。