Documentation

接入文档

通过 MCP 协议将 ATOWN 接入任意 AI 客户端,实现实时 A 股行情查询

快速开始

1

注册并创建 API Key

前往 注册页面 创建免费账号,然后在控制台的 API Keys 页面生成一个新的 Key。Key 仅在创建时完整展示一次,请立即复制保存。

2

配置到你的 AI 客户端

将以下 JSON 配置粘贴到你的 AI 客户端 MCP 配置文件中(例如 Claude Desktop 的 claude_desktop_config.json),并将 Key 替换为你的实际值。

claude_desktop_config.json
{
  "mcpServers": {
    "ATown": {
      "type": "http",
      "url": "https://atown.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY_HERE"
      }
    }
  }
}

可用工具

ATOWN MCP 服务目前提供以下 5 个工具,覆盖 A 股实时行情、历史数据及指数查询。

工具名功能必填参数
GetCurrentDate获取当前日期时间
StockPriceQueryA股实时股价codes: string[]
StockKLineQuery历史K线数据codes, startDate, endDate
StockIndexPriceQuery指数实时行情codes: string[]
StockIndexKLineQuery指数历史K线codes, startDate, endDate

参数说明

codesstring[]股票/指数代码数组,如 ["600519", "000001"]
startDatestring开始日期,格式 YYYY-MM-DD
endDatestring结束日期,格式 YYYY-MM-DD

示例响应

以下为调用 StockPriceQuery 查询贵州茅台(600519)的响应示例:

StockPriceQuery response
{
  "success": true,
  "data": [
    {
      "code": "600519",
      "name": "贵州茅台",
      "price": 1279.00,
      "change": 3.06,
      "changePercent": 0.24,
      "volume": 32156,
      "amount": 4109887232,
      "turnover": 0.026,
      "high": 1285.00,
      "low": 1271.50,
      "open": 1276.00,
      "prevClose": 1275.94
    }
  ],
  "timestamp": "2026-06-11T10:30:00.000Z"
}
price

最新价(元)

changePercent

涨跌幅(%)

volume

成交量(手)

turnover

换手率(%)

常见问题

Q

支持哪些 AI 客户端?

任何支持 MCP 协议的客户端均可接入,包括 Claude Desktop、Cursor、Continue 等。只需在对应客户端的 MCP 配置文件中填入服务地址和 API Key 即可。

Q

免费版有调用次数限制吗?

注册后提供每天 1,000 次免费查询额度,适合个人开发和测试使用。Pro 版为每天 5,000 次,更大量调用可联系 astock@atown.ai。

Q

API Key 泄露了怎么办?

请立即登录控制台,在 API Keys 页面删除已泄露的 Key,并创建新的 Key 替换配置。删除后旧 Key 将立即失效。

Q

数据延迟是多少?

交易时段内实时行情延迟约 3 秒,历史数据为 T+1 更新。数据来源于 RSSCAST 数据平台。

准备好了吗?

立即接入,五分钟完成配置