Finance MCP

Finance MCP コネクター

Finance MCP のコネクター定義です。各ソースの呼び出し方法、受け付ける入力、返される内容を説明します。

このリポジトリはコネクターレイヤーです。エージェントはホスト型サーバーを使用します。ソースの追加はプルリクエストで行います。

株式と暗号資産の数値は各ソースから返されるもので、多くの場合、遅延があります。投資助言ではありません。

クイックスタート

ホスト型サーバーに接続します。

• MCP：https://finance-mcp.com/mcp
• スキル：set up https://finance-mcp.com/SKILL.md
• ドキュメント：finance-mcp.com/docs

Cursor の場合、~/.cursor/mcp.json に設定します。

{
  "mcpServers": {
    "finance-mcp": {
      "url": "https://finance-mcp.com/mcp"
    }
  }
}

Claude Code の場合：

claude mcp add --transport http finance-mcp https://finance-mcp.com/mcp

クライアントから求められたらサインインします。その他のクライアントについてはドキュメントをご覧ください。

エージェントでの使用方法

動詞は3つです。検出、詳細確認、実行は無料です。

1. finance_discover — タスクを説明します。{ "query": "BTC spot price", "limit": 5 } は、ランク付けされた { id, provider, displayName, summary } を返します。
2. finance_inspect — ツールを1つ読み取ります。{ "id": "okx#ticker" } は入力スキーマと出力形式を返します。
3. finance_run — ツールを呼び出します。{ "id": "okx#ticker", "params": { "instId": "BTC-USDT" } }。ベンダーの呼び出しに失敗すると、エラーが返されます。

{ "id": "fmp#income-statement", "params": { "symbol": "AAPL", "period": "annual", "limit": 3 } }
{ "id": "fred#observations", "params": { "seriesId": "DGS10", "limit": 12 } }
{ "id": "sec-edgar#submissions", "params": { "cik": "0000320193" } }
{ "id": "deribit#options", "params": { "currency": "BTC" } }
{ "id": "polymarket#events", "params": { "tag": "Fed" } }

ソース

ソース	上流サービス	認証	エンドポイント
SEC EDGAR	submissions API	SEC_EDGAR_USER_AGENT、またはデフォルトの連絡先文字列	sec-edgar#submissions
FRED	series observations	FRED_API_KEY	fred#observations
Polymarket	Gamma events	なし	polymarket#events
Deribit	get_instruments	なし	deribit#options
OKX	market data	なし	okx#ticker、okx#klines
FMP	income statement	FMP_API_KEY	fmp#income-statement

コネクターの作成

コネクターはプロバイダーとそのエンドポイントを記述します。ID は <provider>#<endpoint> です。

プロバイダーではソースを指定し、そのドキュメントへのリンクと認証情報の提供方法を記述します。

// connectors/okx/provider.ts
export default defineProvider({
  name: "okx",
  meta: {
    displayName: "OKX",
    summary: "Public crypto spot and swap market data.",
    homepageUrl: "https://www.okx.com",
    docsUrl: "https://www.okx.com/docs-v5/en/#order-book-trading-market-data",
  },
  auth: { kind: "none" },
});

エンドポイントでは、呼び出し、入力スキーマ、出力形式、サンプルを定義します。サンプルのレスポンスはフィクスチャファイルで、テストで再生されます。

// connectors/okx/endpoints/ticker/endpoint.ts
export default defineEndpoint({
  provider,
  name: "ticker",
  meta: {
    displayName: "OKX ticker",
    summary: "24h ticker (last price, high/low, volume) for a crypto instrument like BTC-USDT.",
    description: "Latest OKX ticker for one spot or swap instrument.",
    tags: ["crypto", "spot", "ticker"],
    docsUrl: "https://www.okx.com/docs-v5/en/#order-book-trading-market-data-get-ticker",
  },
  input: z.object({
    instId: z.string().describe("Instrument id, for example BTC-USDT."),
  }),
  outputShape: {
    type: "object",
    required: ["instId", "last"],
    properties: { instId: { type: "string" }, last: { type: "string" } },
  },
  example: {
    params: { instId: "BTC-USDT" },
    request: {
      method: "GET",
      url: "https://www.okx.com/api/v5/market/ticker?instId=BTC-USDT",
    },
    fixture: "recorded.json",
  },
  // buildRequest and parse map that call onto the output shape
});

meta.summary は finance_discover がランキングに使用し、finance_inspect が返す内容です。エンドポイントが返すものを記述してください。

connectors/<name>/
├── provider.ts
└── endpoints/<endpoint>/
    ├── endpoint.ts
    ├── endpoint.test.ts
    └── fixtures/*.json

1. connectors/okx と connectors/fred、および CONTRIBUTING.md を読みます。
2. プロバイダーとエンドポイントを作成します。
3. npm run record でフィクスチャを記録し、不要な部分を削除します。
4. ネットワーク接続なしで npm test と npm run lint が成功する必要があります。
5. プルリクエストを作成します。

定義をローカルで確認します。

npm install
npm test
npm run catalog

リポジトリの構成

connectors/     provider + endpoint definitions
src/            catalog load and fixture replay
scripts/        catalog and record
server.json     registry entry for the hosted server

ライセンス

MIT です。LICENSE を参照してください。