项目简介

Financial Reports MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供访问金融报告数据的能力。该服务器集成了 Financial Reports API，允许用户通过标准化的 MCP 协议，轻松地获取公司财务信息、行业分类以及相关数据。

主要功能点

公司数据查询: 支持通过公司名称、国家或行业板块搜索公司信息。
公司详情: 获取公司的详细信息，包括公司概况、财务指标等。
财务报告: 访问最新的公司财务报告，包括年报、季报等。
行业分类: 查询全球行业分类标准 (GICS) 板块和行业信息。
报告详情: 获取财务报告的详细信息和内容摘要。

安装步骤

克隆仓库: 将 GitHub 仓库 'financial-reports-mcp-server' 克隆到本地。
选择安装方式: 根据您的使用场景，选择以下任一安装方式（详细步骤请参考仓库 README.md 文档的 "🚀 Getting Started" 部分）：
- uv (推荐 Claude Desktop): 如果使用 Claude Desktop，推荐使用 'uv' 进行快速安装。
- Docker (推荐可复现环境): 如果需要跨系统可复现的环境，推荐使用 Docker。
- pip 本地安装: 如果您熟悉 Python 环境，可以使用 'pip' 进行本地安装。
- FastMCP CLI: 如果您已安装 'fastmcp' 命令行工具，可以使用其进行安装。

服务器配置

以下是在 Claude Desktop 中配置 Financial Reports MCP Server 的示例，以 'uv' 方式启动服务器：

{
  "mcpServers": {
    "financial-reports": {
      "command": "/path/to/uv",  // 替换为 uv 命令的绝对路径 (如果 uv 已在 PATH 中，则为 "uv")
      "args": [
        "--directory",
        "/absolute/path/to/financial-reports-mcp", // 替换为 financial-reports-mcp 仓库的绝对路径
        "run",
        "server.py"
      ]
    }
  }
}

'command': MCP 服务器的启动命令。根据您的安装方式，可以是 'uv'、'docker' 或 'python' 等。
'args': 启动命令的参数。请根据您的安装方式和实际路径进行调整。
- 使用 'uv' 或 'python' 时，需要指定仓库目录和服务器启动脚本 ('server.py' 或 'main.py') 的路径。
- 使用 'docker' 时，需要指定 Docker 镜像名称和运行参数。

您还需要在仓库根目录下创建 '.env' 文件，并配置 API 密钥和 API 基地址等环境变量。具体配置项请参考仓库 README.md 文档的 "Configuration" 部分。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端 (如 Claude Desktop) 中，即可使用 Financial Reports MCP Server 提供的工具和资源。

可用工具 (Tools):

'search_companies': 搜索公司信息。
'get_company_detail': 获取公司详细信息。
'get_latest_filings': 获取最新财务报告。
'get_filing_detail': 获取报告详细信息。
'list_sectors': 列出行业板块。
'list_filing_types': 列出报告类型。

可用资源 (Resources):

'financial-reports://sectors': 行业板块列表。
'financial-reports://filing-types': 报告类型列表。
'financial-reports://companies/{company_id}/profile': 公司概况。
'financial-reports://companies/{company_id}/recent-filings': 公司近期报告。

您可以使用 LLM 客户端的工具调用或资源读取功能，结合以上工具和资源，实现金融数据查询和分析等应用。例如，您可以要求 LLM "使用 'search_companies' 工具查找 Deutsche Bank 的信息"，或 "读取 'financial-reports://companies/1/profile' 资源获取 Deutsche Bank 的公司概况"。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息