Finance MCP

Finance MCP 连接器

Finance MCP 的连接器定义：各数据源的调用方式、接受的参数以及返回内容。

本仓库是连接器层。Agent 使用托管服务。添加数据源请提交拉取请求。

股票和加密货币数据是这些数据源返回的结果，通常会有延迟。不构成投资建议。

快速开始

连接到托管服务。

• 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

客户端提示时请登录。其他客户端请参阅文档。

Agent 的使用方式

三个操作。发现、查看和运行均免费。

1. finance_discover — 描述任务。{ "query": "BTC spot price", "limit": 5 } 会返回排序后的 { id, provider, displayName, summary }。
2. finance_inspect — 查看一个工具。{ "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。