AStockEvent MCP Server · A股公告事件 MCP 服务

中文 | English

把 A 股公告变成 AI Agent 能直接消费的结构化事件 Feed。

巨潮/东方财富给你公告原文。AStockEvent 给你 AI 可直接消费的结构化事件——及时、快速、不用等日终跑批。

AStockEvent 将 A 股上市公司公告转化为结构化语义事件，让 AI Agent（Claude、ChatGPT、VSCode Copilot 等）通过 MCP 协议直接查询、分析、追踪。

目录

• 功能特性

• 快速开始

• 事件类型

• 工具参考

• 项目结构

• 重要说明

• 许可证

Related MCP server: GroundAPI

功能特性

• 13+ 种事件类型 — 减持、ST/退市、监管函、限售解禁、回购、重组、停复牌、质押、业绩预告、增持、分红、违规处罚、可转债

• 16 个 MCP 工具 — 按股票/类型/股东查询、事件详情/时间线、提前预警、分红/违规/重组/股东/风险/监管专用入口、可转债、基金穿透、可信度报告

• 结构化 Event JSON — 每条事件包含 structured_payload（量化标签）、confidence_tier（verified/likely/uncertain 可信度三级）、ai_summary（AI 摘要）、ai_context（严重度/情绪）、完整 timeline（生命周期时间线）

• 免费额度 — 🚧 开发阶段，无需注册。匿名 100 次/天（MCP + REST 通用），注册功能即将上线 了解详情 →

• MCP stdio 传输 — 兼容 Claude Desktop / VSCode / 任何 MCP 协议兼容的 AI Agent

• 零本地依赖 — MCP Server 是 REST API 薄代理，无需数据库、无需数据采集

快速开始

1. 安装

pip install astockevent

2. Claude Desktop 配置

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "astockevent": {
      "command": "python",
      "args": ["-m", "astockevent.mcp"],
      "env": {
        "ASTOCKEVENT_API_KEY": "your_free_api_key"
      }
    }
  }
}

3. 在 Claude 中使用

配置完成后，Claude 会自动发现 16 个 MCP 工具：

• 按股票查询: "帮我查一下川润股份(002272)这周有没有减持公告"

• 按类型扫描: "最近全市场有哪些 ST/退市风险预警？"

• 事件详情: "展示事件 c8a7f9e1-d2b4-4a3c-8d5e-1f6a9b3c7d4e 的完整数据"

• 提前预警: "未来 7 天有哪些股票有限售股解禁？"

• 可转债: "最近有哪些可转债触发强赎？"

• 基金穿透: "华夏成长混合(000001)的重仓股最近有什么事件？"

• 可信度: "这个减持事件的提取可信度如何？"

4. VSCode Copilot 配置

{
  "mcp": {
    "servers": {
      "astockevent": {
        "command": "python",
        "args": ["-m", "astockevent.mcp"],
        "env": {
          "ASTOCKEVENT_API_KEY": "your_free_api_key"
        }
      }
    }
  }
}

事件类型

Tier 1（MVP — 核心事件）

Tier 2（Phase 2 — 高频高价值）

Tier 3（Phase 2 — 扩展覆盖）

工具参考

核心查询（7 个）

专用入口（7 个）— 预筛选的领域工具

穿透 & 验证（2 个）

向后兼容: check_events 仍可用（已弃用，指向 search_events）。 完整参数参见 MCP 工具自身的 inputSchema（AI Agent 会自动读取）。

项目结构

astockevent-mcp/
├── src/astockevent/
│   ├── mcp/                 # MCP Server（完整源码）
│   │   ├── server.py        # 16 个工具核心逻辑 + dispatch
│   │   ├── stdio_server.py  # MCP stdio 传输层 + Tool 注册
│   │   ├── __init__.py
│   │   └── __main__.py      # python -m astockevent.mcp 入口
│   ├── models/
│   │   └── schemas.py       # Event Schema（Pydantic 模型）
│   └── db/                  # 数据库层桩代码（完整实现在私有仓库）
├── web/                     # Web 看板（HTML/JS）
├── docs/
│   └── api-contract.md      # API 契约文档
└── README.md

重要说明

本仓库是 AStockEvent 的公开子集（Public Subset），仅包含 MCP Server + Event Schema + Web 看板 + API 文档。

公开 vs 私有仓库隔离

同步规则：

• 仅 MCP Server（server.py, stdio_server.py, __init__.py, __main__.py）、Event Schema、Web 看板、API 文档可同步

• 私有 repo MCP 文件变更时自动触发同步（Dev Agent 执行）

• pyproject.toml 公共版保持精简（仅 3 个依赖），与私有版不同

• 同步前自动确认无硬编码 IP/密钥/内部路径泄露

安全红线：

• 公开 repo 不包含任何数据库连接信息、API 密钥、服务器 IP

• 公开 repo 不包含 Extractor 引擎（核心竞争力）

• 公开 repo 不包含 Golden Dataset（护城河资产）

MCP Server 是 REST API 的薄代理层——通过 HTTP 连接 api.astockevent.com，不包含数据库或管线逻辑。

完整后端代码参见私有仓库 NengjiangLunpi/astockevent（PRIVATE）。

联系方式

• 邮箱: astockevent@outlook.com

• API 注册: astockevent.com/register

• GitHub Issues: 公开 repo

API 契约

完整 REST API + MCP Tool 规范见 docs/api-contract.md。

许可证

MIT License — 详见 LICENSE。

English

Transform A-share listed company announcements into structured event feeds that AI agents can directly consume.

Cninfo/Eastmoney gives you raw announcements. AStockEvent gives you AI-ready structured events — timely, fast, no batch processing needed.

AStockEvent transforms A-share listed company announcements into structured semantic events, enabling AI agents (Claude, ChatGPT, VSCode Copilot, etc.) to query, analyze, and track them through the MCP protocol.

Features

• 13+ Event Types — share reduction, ST/delisting risk, regulatory letters, lockup expiration, buybacks, restructuring, trading halts, pledge risk, earnings forecasts, share increase, dividends, violations, convertible bonds

• 16 MCP Tools — query by stock/type/shareholder, event detail & timeline, early warning, 6 domain-specialized tools (dividend/violation/restructuring/shareholder/risk/regulatory), convertible bonds, fund penetration, trust reports

• Structured Event JSON — each event includes structured_payload (quantitative tags), confidence_tier (verified/likely/uncertain), ai_summary, ai_context (severity/sentiment), and full timeline

• Free Tier — 🚧 Dev phase: no registration required. Anonymous 100 calls/day (REST + MCP). Registration coming soon Learn more →

• MCP stdio transport — compatible with Claude Desktop / VSCode / any MCP-compatible AI agent

• Zero Local Dependencies — MCP Server is a thin REST API proxy. No database, no data collection needed.

Quick Start

1. Installation

pip install astockevent

2. Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "astockevent": {
      "command": "python",
      "args": ["-m", "astockevent.mcp"],
      "env": {
        "ASTOCKEVENT_API_KEY": "your_free_api_key"
      }
    }
  }
}

3. Usage in Claude

Once configured, Claude automatically discovers 16 MCP tools:

• By stock: "Check if 川润股份 (002272) has any share reduction announcements this week"

• By type: "Show me all ST/delisting risk warnings across the market"

• Event detail: "Show the full timeline of event c8a7f9e1-d2b4-4a3c-8d5e-1f6a9b3c7d4e"

• Early warning: "Which stocks have lockup shares expiring in the next 7 days?"

• Convertible bonds: "Any convertible bonds triggering forced redemption recently?"

• Fund penetration: "What events happened to 华夏成长混合 (000001)'s heavy holdings?"

• Trust report: "How reliable is the extraction for this share reduction event?"

4. VSCode Copilot Configuration

{
  "mcp": {
    "servers": {
      "astockevent": {
        "command": "python",
        "args": ["-m", "astockevent.mcp"],
        "env": {
          "ASTOCKEVENT_API_KEY": "your_free_api_key"
        }
      }
    }
  }
}

Event Types

Tier 1 (MVP — Core Events)

Tier 2 (Phase 2 — High Frequency, High Value)

Tier 3 (Phase 2 — Extended Coverage)

Tools Reference

Core Query (7)

Domain-Specialized (7) — Pre-filtered convenience tools

Penetration & Verification (2)

Backward compat: check_events still works (deprecated, points to search_events). Full parameter details are in each tool's inputSchema (AI agents read them automatically).

API Contract

See docs/api-contract.md for the complete REST API + MCP Tool specification.

Project Structure

astockevent-mcp/
├── src/astockevent/
│   ├── mcp/                 # MCP Server (full source)
│   │   ├── server.py        # 16 Tool core logic + dispatch
│   │   ├── stdio_server.py  # MCP stdio transport layer
│   │   ├── __init__.py
│   │   └── __main__.py      # python -m astockevent.mcp entry point
│   ├── models/
│   │   └── schemas.py       # Event Schema (Pydantic)
│   └── db/                  # Database layer stub (full impl in private repo)
├── web/                     # Web dashboard (HTML/JS)
├── docs/
│   └── api-contract.md      # API contract documentation
└── README.md

Important Note

This repository is the public subset of AStockEvent, containing only MCP Server + Event Schema + Web Dashboard + API documentation.

Public vs Private Repository Separation

Sync Rules:

• Only MCP Server (server.py, stdio_server.py, __init__.py, __main__.py), Event Schema, Web Dashboard, and API docs may be synced to the public repo

• Sync is automated — Dev Agent executes when private repo MCP files change

• Public pyproject.toml is intentionally slim (3 deps only), different from private

• Pre-sync review ensures no hardcoded IPs, keys, or internal paths leak

Security Red Lines:

• Public repo contains NO database credentials, API keys, or server IPs

• Public repo contains NO Extractor engine (core competitive advantage)

• Public repo contains NO Golden Dataset (moat asset)

The MCP Server is a thin REST API proxy — it connects to api.astockevent.com via HTTP, with no database or pipeline logic included.

Complete backend source: NengjiangLunpi/astockevent (PRIVATE).

Contact

• Email: astockevent@outlook.com

• API Registration: astockevent.com/register

• GitHub Issues: Public Repo

License

MIT License — see LICENSE.