A股公告摘要 MCP 工具

一个基于 Model Context Protocol (MCP) 的工具，用于获取A股上市公司公告并提供智能摘要功能。

项目简介

本项目旨在解决A股上市公司公告内容过长、阅读繁琐的问题。通过输入上市公司名称或代码，可以自动获取其公告列表，并对公告内容进行智能摘要，帮助用户快速了解公告核心信息。

核心功能

• 🔍 公司搜索：支持通过公司名称或股票代码搜索上市公司
• 📋 公告列表：获取指定公司的所有公告，包括年报、季报等
• 📝 智能摘要：使用智谱AI对公告内容进行智能摘要
• 📚 历史查询：支持查询历史公告
• 💾 缓存机制：自动缓存已获取和摘要的公告，避免重复处理
• 🎯 MCP集成：遵循Model Context Protocol标准，可集成到支持MCP的应用中

技术栈

• 语言：Python 3.10+
• 数据源：东方财富网、巨潮资讯等公开API
• AI服务：智谱AI API（需配置）
• MCP协议：Model Context Protocol
• 缓存：本地文件缓存

目录结构

mcp-a-stock-announcements/
├── src/
│   ├── __init__.py
│   ├── main.py              # MCP服务器主入口
│   ├── stock_api.py         # 股票数据API接口
│   ├── ai_summary.py        # AI摘要服务
│   ├── cache_manager.py     # 缓存管理
│   └── mcp_server.py        # MCP服务器实现
├── config/
│   ├── config.example.yaml  # 配置文件示例
│   └── config.yaml          # 实际配置文件（需自行创建）
├── cache/                   # 缓存目录
├── tests/                   # 测试目录
├── .gitignore
├── requirements.txt
├── pyproject.toml
└── README.md

安装与配置

1. 克隆项目

git clone <repository-url>
cd mcp-a-stock-announcements

2. 安装依赖

pip install -r requirements.txt

3. 配置智谱AI API

复制配置文件示例：

cp config/config.example.yaml config/config.yaml

编辑 config/config.yaml，填入你的智谱AI API密钥：

zhipuai:
  api_key: "your-zhipuai-api-key"
  model: "glm-4"  # 可选：glm-4, glm-3-turbo 等

cache:
  enabled: true
  ttl: 86400  # 缓存有效期（秒），默认24小时
  directory: "./cache"

4. 获取智谱AI API密钥

访问 智谱AI开放平台 注册并获取API密钥。

本地启动

方式一：直接运行

python -m src.main

方式二：作为MCP服务器运行

mcp-server src/main.py

MCP工具使用说明

工具列表

1. search_company

搜索A股上市公司

参数：

• query (string): 公司名称或股票代码

返回：

• 公司基本信息（代码、名称、行业等）

2. get_announcements

获取公司公告列表

参数：

• stock_code (string): 股票代码
• limit (integer, 可选): 返回数量限制，默认20

返回：

• 公告列表（标题、日期、类型、链接等）

3. summarize_announcement

摘要公告内容

参数：

• announcement_url (string): 公告链接
• force_refresh (boolean, 可选): 是否强制刷新缓存，默认false

返回：

• 公告摘要内容

使用示例

# 搜索公司
result = await mcp_client.call_tool("search_company", {"query": "贵州茅台"})

# 获取公告列表
announcements = await mcp_client.call_tool("get_announcements", {
    "stock_code": "600519",
    "limit": 10
})

# 摘要公告
summary = await mcp_client.call_tool("summarize_announcement", {
    "announcement_url": "https://...",
    "force_refresh": False
})

开发说明

运行测试

pytest tests/

代码格式化

black src/
isort src/

类型检查

mypy src/

部署到iFlow MCP工具市场

待项目完成后，将按照iFlow MCP工具市场的规范进行打包和发布。

注意事项

1. API密钥安全：请勿将包含真实API密钥的配置文件提交到Git仓库
2. 缓存管理：定期清理缓存目录，避免占用过多磁盘空间
3. API限制：智谱AI API有调用频率限制，请注意合理使用
4. 数据准确性：公告数据来源于公开渠道，请以官方发布为准

许可证

MIT License

贡献

欢迎提交Issue和Pull Request！

联系方式

如有问题或建议，请通过Issue反馈。