基于 akshare 的 MCP (Model Context Protocol) 服务器，提供股票、加密货币的数据查询和分析功能。

• 🔍 股票搜索: 根据股票名称、公司简称等关键词查找股票代码
• ℹ️ 股票信息: 获取股票的详细信息，包括价格、市值等
• 📊 市场概况: 获取A股市场的涨停板、龙虎榜、资金流向等
• 💹 历史价格: 获取股票、加密货币历史价格数据，包含技术分析指标
• 📰 相关新闻: 获取股票、加密货币相关的最新新闻资讯
• 💸 财务指标: 支持A股和港美股的财务报告关键指标查询

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": ["mcp-aktools"],
      "env": {
        # 全部可选
        "OKX_BASE_URL": "https://okx.4url.cn", # OKX地址，如果你的网络环境无法访问okx.com，可通过此选项配置反代地址
        "BINANCE_BASE_URL": "https://bian.4url.cn", # 币安地址，默认: https://www.binance.com
        "NEWSNOW_BASE_URL": "https://newsnow.busiyi.world", # Newsnow接口地址
        "NEWSNOW_CHANNELS": "wallstreetcn-quick,cls-telegraph,jin10", # Newsnow资讯来源
      }
    }
  }
}

需要通过OAuth授权或Smithery key

{
  "mcpServers": {
    "aktools": {
      "url": "https://server.smithery.ai/@aahl/mcp-aktools/mcp" # Streamable HTTP
    }
  }
}

mkdir /opt/mcp-aktools
cd /opt/mcp-aktools
wget https://raw.githubusercontent.com/aahl/mcp-aktools/refs/heads/main/docker-compose.yml
docker-compose up -d

{
  "mcpServers": {
    "aktools": {
      "url": "http://0.0.0.0:8808/mcp" # Streamable HTTP
    }
  }
}

• 在线体验:
• 在线体验:
• 添加到 Cursor
• 添加到 VS Code
• 添加到 Cherry Studio
• 添加到 Claude Code, 执行命令: claude mcp add aktools -- uvx mcp-aktools
• 添加到 OpenAI CodeX, 执行命令: codex mcp add aktools -- uvx mcp-aktools

从当前版本开始，所有 MCP 工具统一返回结构化 JSON，不再混用纯文本、CSV 字符串和临时字典。

统一外层结构如下：

{
  "ok": true,
  "kind": "timeseries",
  "data": {},
  "error": null,
  "meta": {
    "source": "akshare",
    "generated_at": "2026-04-14T12:00:00+08:00"
  }
}

失败时：

{
  "ok": false,
  "kind": "timeseries",
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "No data found"
  },
  "meta": {
    "source": "akshare",
    "generated_at": "2026-04-14T12:00:00+08:00"
  }
}

kind 目前收敛为以下几类：

• search_result
• entity_profile
• timeseries
• table
• news_list
• snapshot
• advice

这套设计面向 AI 通过 MCP 消费数据：

• AI 可以先看 ok 判断成功或失败
• 再看 kind 决定如何理解 data
• meta 提供来源、数量、生成时间等辅助信息

可以直接用 mcporter 通过 stdio 启动并测试这个 MCP：

mcporter --config ./config/mcporter.json list \
  --stdio .venv/bin/python \
  --stdio-arg -m \
  --stdio-arg mcp_aktools \
  --cwd /abs/path/to/mcp-aktools \
  --schema

调用工具示例：

mcporter --config ./config/mcporter.json call \
  --stdio .venv/bin/python \
  --stdio-arg -m \
  --stdio-arg mcp_aktools \
  --cwd /abs/path/to/mcp-aktools \
  "stock_info(symbol: \"600519\", market: \"sh\")" \
  --output raw

mcporter --config ./config/mcporter.json call \
  --stdio .venv/bin/python \
  --stdio-arg -m \
  --stdio-arg mcp_aktools \
  --cwd /abs/path/to/mcp-aktools \
  get_current_time \
  --output raw

• --output json 更偏向展示 structuredContent.data，适合快速看业务结果。
• --output raw 会显示完整 MCP ToolResult，其中包含 structuredContent，更适合检查完整响应外壳。
• 纯数字股票代码建议显式加引号，例如 "600519"。否则 CLI 可能把参数推断成数字，触发字符串类型校验错误。
• 如果更想稳定传参，优先使用 function-call 语法或 --args JSON，而不是未加引号的 key=value。