agushuju-mcp — 爱股数据 MCP Server

在 Claude Desktop、Cursor 等 MCP 客户端里用自然语言查 A 股/基金/期货数据：

"平安银行最近的日线行情" · "今天涨停的股票有哪些" · "螺纹钢主力合约这个月的走势"

底层封装爱股数据 REST API（复用 agushuju Python SDK）， 使用你自己的平台 token——鉴权、限流、计费全部走平台既有体系，与本 Server 无关。

工具清单（首批 12 + 1）

参数约定：日期一律 YYYY-MM-DD；代码带交易所后缀（股票 000001.SZ、指数 000001.SH、期货 RB2601.SHF）；返回 markdown 表格，默认 10 行、单次最多 50 行，offset 翻页。

安装与配置

1. 获取 token

在 API Key 管理页 创建你的 token。

2. 安装

pip install agushuju-mcp
# 依赖 agushuju SDK 自动从 PyPI 安装

# 开发模式（本仓库源码）
pip install -e sdk/python
pip install -e sdk/mcp

发版：python sdk/publish.py（与 SDK 同流程，自动保证 SDK 先于 MCP 上传）。

3. Claude Desktop 配置

claude_desktop_config.json（Claude Desktop → 设置 → Developer → Edit Config）：

{
  "mcpServers": {
    "agushuju": {
      "command": "agushuju-mcp",
      "env": {
        "AGUSHUJU_TOKEN": "你的token"
      }
    }
  }
}

Windows 下 command 可能需要写 python 可执行文件完整路径，用 python -c "import sys; print(sys.executable)" 查出后配置为：

{
  "mcpServers": {
    "agushuju": {
      "command": "C:\\Users\\你\\...\\python.exe",
      "args": ["-m", "agushuju_mcp.server"],
      "env": { "AGUSHUJU_TOKEN": "你的token" }
    }
  }
}

4. Cursor 配置

.cursor/mcp.json：

{
  "mcpServers": {
    "agushuju": {
      "command": "agushuju-mcp",
      "env": { "AGUSHUJU_TOKEN": "你的token" }
    }
  }
}

配置后重启客户端，工具列表出现「爱股数据」即接入成功；先问一句 "查一下服务状态" 跑 health_check 验证链路。

环境变量

错误排查

相关链接

• 接口文档：https://www.agushuju.com/doc
• 定价与限流：https://www.agushuju.com/pricing
• Python SDK：sdk/python