Streamable HTTP MCP

MCP 接入

把 AShare 的 123 个公开接口接入支持 MCP 的 Agent、IDE 或自动化客户端。MCP 调用使用同一套 API Key、套餐配额、Redis 限流和调用审计。

POST /mcp统一 MCP 入口

接入信息

生产地址	https://ashare.zzzzz.ai/mcp
本地地址	http://localhost:8080/mcp
传输方式	Streamable HTTP，使用 JSON-RPC 2.0 请求体
请求方法	POST
认证方式	Authorization: Bearer <api_key> 或 X-API-Key: <api_key>

可用工具

工具	用途	关键参数
ashare_endpoint_search	搜索公开接口目录	query, limit
ashare_endpoint_call	通过付费网关调用一个接口	endpoint_id, params
ashare_usage	查看当前 API Key 的套餐和用量	无必填参数

调用接口时请使用网站接口文档里的公开参数名，例如 stock_code、page_offset。网关会在内部翻译为授权源字段。

客户端配置

如果客户端支持远程 Streamable HTTP MCP，配置 URL 和鉴权头即可。

{
  "url": "https://ashare.zzzzz.ai/mcp",
  "headers": {
    "Authorization": "Bearer <api_key>"
  }
}

如果你的客户端只支持 stdio MCP，需要先通过支持 Streamable HTTP 的桥接器连接该地址。

1. 列出工具

curl -X POST \
  -H "Authorization: Bearer $ASHARE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  https://ashare.zzzzz.ai/mcp

2. 搜索接口

{
  "jsonrpc": "2.0",
  "id": "search",
  "method": "tools/call",
  "params": {
    "name": "ashare_endpoint_search",
    "arguments": {
      "query": "日K",
      "limit": 5
    }
  }
}

3. 调用接口

{
  "jsonrpc": "2.0",
  "id": "call",
  "method": "tools/call",
  "params": {
    "name": "ashare_endpoint_call",
    "arguments": {
      "endpoint_id": "getklineday-w14-stocklinedata",
      "params": {
        "stock_code": "000001",
        "period": "d",
        "page_offset": "0",
        "include_intraday": "1"
      }
    }
  }
}

接口调用会计入当前 API Key 的套餐用量，并出现在后台调用审计中。

常见问题

GET /mcp 可以打开吗？

不可以。MCP 协议入口只处理 POST JSON-RPC 请求，浏览器直接 GET 会返回 405。

是否需要单独的 MCP Key？

不需要，使用控制台中的 AShare API Key 即可。

和 REST API 的参数一样吗？

一样，MCP 工具使用网站文档展示的公开参数名。