---
title: SEC Financial Data MCP Server
emoji: 📊
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
---

# SEC Financial Data MCP Server (FastMCP)

🚀 **已迁移到 Anthropic 官方 FastMCP SDK** - 代码量减少 84%，更简洁、更易维护！

## ✨ 新特性

- ✅ 使用 Anthropic 官方 FastMCP SDK (v1.2.0)
- ✅ 代码从 636 行缩减到 ~200 行 (减少 84%)
- ✅ 纯 JSON 响应（`json_response=True`）
- ✅ 使用装饰器定义工具（`@mcp.tool()`）
- ✅ 100% MCP 协议兼容
- ✅ SSE 传输支持

## 📊 工具列表

1. **search_company** - 按公司名称搜索
2. **get_company_info** - 获取公司详细信息
3. **get_company_filings** - 获取SEC文件列表
4. **get_financial_data** - 获取特定期间财务数据
5. **extract_financial_metrics** - 提取多年财务指标（支持按年度和季度，时间降序）
6. **get_latest_financial_data** - 获取最新财务数据
7. **advanced_search_company** - 高级搜索（支持公司名/CIK）

## 🔗 MCP 端点

- **SSE 传输**: `https://your-space.hf.space/sse`
- **方法**: POST
- **格式**: JSON-RPC 2.0

## 📝 使用示例

### 客户端配置

将以下配置添加到你的 MCP 客户端（如 Claude Desktop）：

```json
{
  "mcpServers": {
    "sec-financial-data": {
      "url": "https://jc321-easyreportdatamcp.hf.space/sse",
      "transport": "sse"
    }
  }
}
```

### MCP 请求示例

```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_company",
    "arguments": {
      "company_name": "Tesla"
    }
  },
  "id": 1
}
```

### 响应格式（纯 JSON）

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"cik\":\"0001318605\",\"name\":\"TESLA, INC.\",\"tickers\":[\"TSLA\"],\"sic\":\"3711\",\"sic_description\":\"Motor Vehicles & Passenger Car Bodies\"}"
      }
    ]
  }
}
```

## 🚀 部署

### Hugging Face Space

1. 推送代码到 HF Space
2. 服务自动启动在端口 7860
3. MCP 端点: `https://your-space.hf.space/sse`

### 本地运行

```bash
pip install -r requirements.txt
python app.py
```

服务将启动在 `http://0.0.0.0:7860/sse`

## 📦 依赖

- `mcp[cli]==1.2.0` - Anthropic 官方 MCP SDK
- `sec-edgar-api==1.1.0` - SEC EDGAR API
- `fastapi==0.109.0` - Web 框架
- `uvicorn[standard]>=0.30` - ASGI 服务器（mcp 要求 >=0.30）
- `pydantic>=2.10.1` - 数据验证（mcp 要求 >=2.10.1）

## 🔄 从旧版本迁移

旧版本使用的是手动实现的 MCP 服务器（`mcp_server_sse.py`）。新版本已完全迁移到 FastMCP：

- ✅ 所有 7 个工具功能完全相同
- ✅ 所有响应格式完全相同（纯 JSON）
- ✅ MCP 客户端配置只需将 URL 端点从 `/sse` 保持为 `/sse`（无需更改）
- ✅ 代码更简洁，维护更容易

## 📚 技术栈

- **MCP SDK**: Anthropic FastMCP 1.2.0
- **SEC API**: sec-edgar-api 1.1.0
- **Web框架**: FastAPI + Uvicorn
- **Python**: 3.10+

## 🎯 数据排序

财务数据按时间降序排列：
- FY2024 → 2024Q4 → 2024Q3 → 2024Q2 → 2024Q1
- FY2023 → 2023Q4 → 2023Q3 → 2023Q2 → 2023Q1
- ...

## 📄 License

MIT License