Financial Reports MCP Server

🚀 金融报告 MCP 服务器

这是一个用于处理金融数据报告的MCP（多协议通信）服务器，支持多种接口和功能，能有效助力金融数据的处理与查询。

🚀 快速开始

先决条件

系统要求

• 操作系统：Linux、macOS、Windows（推荐使用Docker）
• Python版本：3.8+

安装依赖

pip install -r requirements.txt

启动方式

有多种启动方式可供选择：

方式一：直接运行

python mcp_server.py

方式二：使用uv（推荐用于Windows）

1. 安装uv：

   npm install -g uv
   

2. 启动服务：

   uv mcp_server.uv
   

方式三：Docker运行

docker build -t financial-reports-mcp .
docker run --rm -it financial-reports-mcp

配置说明

请将以下内容写入配置文件（.env）：

API_KEY=your_api_key
DB_HOST=localhost
DB_PORT=5432

✨ 主要特性

• 行业分类：支持GICS（全球行业分类标准）行业的查询与管理
• 文件类型：提供各类财务报表类型的详细信息
• 公司信息：支持对公司进行多维度搜索与详情查询
• ** filings 获取**：可以获取公司的最新财务报告
• 数据源：支持多种数据源的查询与管理

📦 安装指南

系统要求

• 操作系统：Linux、macOS、Windows（推荐使用Docker）
• Python版本：3.8+

安装依赖

pip install -r requirements.txt

💻 使用示例

基础用法

示例 1：查询公司信息

我需要查找德意志银行的基本信息，包括其所在国家、行业以及最新的财务报告。

示例 2：获取行业信息

请列出所有与科技相关的GICS行业，并提供每个行业的详细描述。

高级用法

可通过核心接口进行更灵活的查询：

• get_filing_type(filing_type_id)：通过文件类型ID获取详细信息
• list_industries(...)：列出所有GICS行业
• get_company_detail(company_id)：通过公司ID获取详情

📚 详细文档

项目结构

financial-reports-mcp/
├── mcp_server.py          # 主程序入口
├── resources/            # 资源文件
│   ├── sectors.md        # 行业分类列表
│   └── filing_types.md   # 文件类型列表
├── schemas/              # OpenAPI3 Schema 定义
│   └── api.json          # API 接口定义
└── requirements.txt      # 依赖管理文件

可用资源

核心接口

• get_filing_type(filing_type_id)：通过文件类型ID获取详细信息
• list_industries(...)：列出所有GICS行业
• get_company_detail(company_id)：通过公司ID获取详情

示例资源

• financial-reports://sectors：所有GICS行业的列表
• financial-reports://filing-types：所有文件类型的列表

多平台兼容性

• Linux：支持所有启动方式
• macOS：支持所有启动方式
• Windows：
  • 建议使用uv进行Claude Desktop部署
  • Docker需安装Docker Desktop for Windows

🔧 技术细节

故障排除

常见问题

1. 通信问题：

   • 确保使用stdio传输模式
   • Docker启动时添加-i参数

2. 模块未找到：

   • 安装所有依赖：pip install -r requirements.txt

3. 连接不上服务器：

   • 检查服务器是否已成功启动并监听相应端口

4. API认证失败：

   • 确认.env文件中的API_KEY配置正确

日志查看

• 直接运行时：日志输出到控制台
• Docker运行时：使用docker logs <container-id>查看

📄 许可证

本项目遵循MIT License协议。

📞 联系方式

如需帮助或反馈问题，请联系：

• 邮箱：support@financial-reports.com
• 电话：+86-123-4567890