MCP Server Financeiro

金融 MCP サーバー

このプロジェクトは、Go を使用してシンプルな MCP サーバーを構築する方法を示す実践的な例です。
金融ツールの管理をシミュレートし、Alpha Vantage の公開 API を使用して株価をリアルタイムで取得します。

目的は、/metadata エンドポイントの公開を含め、Model Context Protocol（MCP）の基本原則に従うサーバーの構成方法を示すことです。

機能

• 金融ツールを動的に登録する
• 登録済みのすべてのツールを一覧表示する
• 株価をリアルタイムで取得する（Alpha Vantage）
• クライアントエージェント向けに MCP 標準のメタデータを公開する

エンドポイントの構成

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 サーバーのメタデータを取得する

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

前提条件

• API キーを取得するための Alpha Vantage の無料アカウント

プロジェクトの実行方法

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 で利用できます。