AStockEvent MCP 接入指南
让 AI Agent 帮你实时盯 A 股公告 —— 一条命令，16 个工具，13 种事件类型
1. 什么是 MCP？
MCP（Model Context Protocol） 是 AI 世界的 "USB 接口"——让 AI Agent 能直接调用外部工具和数据源。
没有 MCP：你问 Claude "川润股份最近有减持公告吗？"
Claude 回答："我无法获取实时数据，建议你去巨潮资讯网查询。"
有了 AStockEvent MCP：同一个问题
Claude 自动调用 search_events_by_stock → 返回结构化结果 → "川润股份(002272) 6月8日发布减持预披露公告，股东XXX计划减持不超过X股，当前处于计划阶段，可信度 已验证。"
2. 安装（30 秒）
需要 Python 3.11+。一行命令：
pip install astockevent验证安装：
python -c "import astockevent; print(astockevent.__version__)"
# → 0.2.13. 额度说明
无需注册，开箱即用。 当前每天可调用 100 次，个人使用完全够用。
如果需要更高额度，可以添加 ASTOCKEVENT_API_KEY 环境变量（注册功能即将上线，注册后额度 200 次/天）。下方的配置示例已经是即复制即用的最简版本——不需要填任何 Key。
4. 接入 Claude Desktop
打开 claude_desktop_config.json（位置见下），添加：
{
"mcpServers": {
"astockevent": {
"command": "python",
"args": ["-m", "astockevent.mcp"]
}
}
}| 系统 | 配置文件路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
重启 Claude Desktop 后生效。工具栏会出现 🔌 图标，点击可查看 16 个工具。
5. 接入 Hermes Agent
编辑 ~/.hermes/config.yaml，在 mcp_servers: 下添加：
mcp_servers:
astockevent:
command: "python"
args: ["-m", "astockevent.mcp"]重启 Hermes 或执行 /reload-mcp 即可生效。
6. 接入 Cursor
Cursor 设置 → MCP → 添加新 Server：
{
"mcpServers": {
"astockevent": {
"command": "python",
"args": ["-m", "astockevent.mcp"]
}
}
}7. 接入 VSCode Copilot
在 VSCode 设置中搜索 mcp，或直接编辑 .vscode/mcp.json：
{
"mcp": {
"servers": {
"astockevent": {
"command": "python",
"args": ["-m", "astockevent.mcp"]
}
}
}
}8. 16 个 MCP 工具速览
| 分类 | 工具 | 用途 |
|---|---|---|
| 🔍 核心查询 | search_events_by_stock | 按股票代码查事件 |
| search_events_by_type | 按事件类型全市场扫描 | |
| search_events_by_shareholder | 按股东名称追踪 | |
| search_events | 万能入口 — 全部筛选器组合 | |
| get_event_detail | 单条事件完整数据 | |
| get_event_timeline | 事件生命周期时间线 | |
| get_upcoming_events | 未来 N 天到期预警 | |
| 🎯 专用入口 | search_dividend_events | 分红/送转 |
| search_violation_events | 违规处罚 | |
| search_restructuring_events | 资产重组/并购 | |
| search_shareholder_events | 股东行为全景 | |
| search_risk_events | 风险预警 | |
| search_regulatory_events | 监管信号 | |
| search_cb_events | 可转债 | |
| 🔬 穿透验证 | search_fund_events | 基金穿透 — 基金→重仓股×事件交叉 |
| get_trust_report | 可信度报告 — 多源交叉验证 |
共 16 个工具，覆盖 13 种事件类型（减持/ST退市/监管函/限售解禁/回购/资产重组/停复牌/质押/业绩预告/增持/分红/违规处罚/可转债）。
9. 使用示例
配置好 MCP 后，直接对 AI Agent 说人话：
按股票查询减持
💬 "帮我查一下川润股份(002272)这周有没有减持公告"
全市场 ST 风险扫描
💬 "最近全市场有哪些 ST / 退市风险预警？按严重程度排序"
限售解禁提前预警
💬 "未来 7 天有哪些股票有限售股解禁？帮我列出解禁比例最大的前 10 只"
可转债事件
💬 "最近有哪些可转债触发强赎？"
基金穿透
💬 "华夏成长混合(000001)的重仓股最近有什么事件？按影响评分排序"
可信度验证
💬 "这个减持事件的提取可信度如何？帮我查一下 trust report"
10. 常见问题
- Q: 网络需要特殊配置吗？
- 不需要。MCP Server 在本地运行，通过 HTTPS 通信，国内网络直连可用。
- Q: 数据从哪里来？
- 来自巨潮资讯网、深交所、东方财富等 A 股官方信息披露渠道，多源交叉验证确保准确性。
- Q: 支持哪些 AI Agent？
- Claude Desktop、Hermes Agent、Cursor、VSCode Copilot，以及任何支持 MCP stdio 协议的 AI 客户端。
- Q: REST API 和 MCP 有什么区别？
- REST API 适合程序代码直接调用（Python/JS/Go HTTP 请求）。MCP 适合 AI Agent 场景——Agent 自动发现工具、自动调用，你只需要用自然语言提问。两者使用同一数据源。
- Q: 需要注册吗？
- 不需要。当前开箱即用，每日 100 次调用。注册功能上线后，注册用户可获更高额度。