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 獲取**：可以獲取公司的最新財務報告
• 數據源：支持多種數據源的查詢與管理

📚 詳細文檔

項目結構

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：所有文件類型的列表

提示示例

示例 1：查詢公司信息

我需要查找德意志銀行的基本信息，包括其所在國家、行業以及最新的財務報告。

示例 2：獲取行業信息

請列出所有與科技相關的GICS行業，並提供每個行業的詳細描述。

多平臺兼容性

• 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