PACKAGE EXPLORERView in registry

agushuju-mcp

PyPI

爱股数据（agushuju.com）MCP Server — 在 Claude Desktop / Cursor 等 AI 客户端查询 A 股/基金/期货数据

Versions collected1

Direct dependencies2From release 0.1.1

Last observed21 Oct, 09:32 UTC

README

Version 0.1.1 documentation

agushuju-mcp — 爱股数据 MCP Server

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

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

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

工具清单（首批 12 + 1）

工具	数据
`stock_basic`	股票基础信息（名称/行业/上市日期）
`stock_daily`	A 股日线行情
`stock_daily_basic`	每日指标（换手率/量比/市盈率/市值）
`trade_calendar`	交易日历（SSE/SZSE）
`stock_moneyflow`	个股资金流向（主力/大中小单）
`stock_top_list`	龙虎榜每日明细
`index_daily`	指数日线
`fund_daily`	ETF/基金日线
`futures_daily`	期货日线
`stock_fina_indicator`	财务指标（EPS/ROE/营收增速）
`stock_limit_list`	每日涨跌停列表
`stock_stk_limit`	每日涨跌停价格
`health_check`	服务状态探活

参数约定：日期一律 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 验证链路。

环境变量

变量	说明
`AGUSHUJU_TOKEN`	平台 API Key（必填）
`AGUSHUJU_API_BASE`	服务地址，默认 https://www.agushuju.com（本地调试可指 http://127.0.0.1:8181）

错误排查

现象	处理
未设置 AGUSHUJU_TOKEN	检查 mcpServers 配置的 env 字段
code=401	token 无效/过期，到 API Key 页重建
code=429	触发限流（免费档每接口 200 次/日），见定价页
服务不可达	用 `health_check` 探活；查看服务状态页

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.1.1	3 Oct 2026	2

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 09:32 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:f41f234737a28d6af6309abb881140a70d8229955dc258bcb3a9004ac1c82768