项目简介 Massive.com MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的应用后端，旨在将 Massive.com 丰富的金融市场数据 API 转换为 LLM（大型语言模型）可直接调用的工具。它支持多种金融资产的数据查询，包括实时和历史交易数据、行情、市场快照、财务基本面以及市场状态等，使得 LLM 能够以对话方式轻松获取和处理复杂的金融信息。
主要功能点
- 金融市场数据访问： 提供对股票、期权、外汇、加密货币的聚合数据、交易记录、实时报价等。
- 参考数据查询： 获取股票代码详情、新闻、分红、拆股、市场状况和节假日信息。
- 财务基本面分析： 检索公司的基本财务数据和财报信息。
- 市场情绪洞察： 提供分析师洞察、评级、收益报告、指引数据等。
- 期货市场数据： 查询期货合约的聚合数据、报价、交易、产品详情和市场状态。
- 统一接口： 将 Massive.com API 的所有功能封装为标准化的 MCP 工具，方便 LLM 调用。
- 数据格式化： 将 API 响应自动转换为 LLM 易于处理的扁平化 CSV 格式。
- 多种传输协议支持： 默认支持 STDIO，并可通过配置支持 SSE 和 Streamable HTTP。

安装步骤

前提条件： 确保已安装 Python 3.10+ 和 Astral UV。您还需要一个 Massive.com API 密钥。

安装 Claude Code CLI (如果使用 Claude CLI)：

npm install -g @anthropic-ai/claude-code

通过 Claude CLI 添加 Massive MCP 服务器： 使用以下命令将服务器安装到您的本地环境。请将 'your_api_key_here' 替换为您的实际 Massive.com API 密钥。

claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- uvx --from git+https://github.com/massive-com/[email protected] mcp_massive

或者，如果您想在本地进行开发和调试，可以在项目目录下运行：

uv sync
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

请注意，'uvx' 或 'uv' 命令可能需要提供完整路径，例如 '/home/username/.cargo/bin/uvx'。

服务器配置 (供 MCP 客户端连接) MCP 客户端（例如 Claude Desktop）需要配置服务器的启动命令。以下是配置 Massive.com MCP 服务器的 JSON 示例，请根据您的实际环境进行修改：

{
    "mcpServers": {
        "massive": {
            // MCP 服务器的启动命令。
            // 确保替换为您的 uvx 安装的完整路径，例如 "/home/username/.cargo/bin/uvx"
            "command": "<path_to_your_uvx_install>/uvx",
            // 传递给启动命令的参数。
            // "--from" 指定从 GitHub 仓库安装，"@v0.6.0" 指定版本。
            // "mcp_massive" 是要运行的 Python 包名。
            "args": [
                "--from",
                "git+https://github.com/massive-com/[email protected]",
                "mcp_massive"
            ],
            // 服务器运行所需的环境变量。
            "env": {
                // 您的 Massive.com API 密钥，请替换为真实密钥。
                "MASSIVE_API_KEY": "<your_api_key_here>",
                // 您的主目录路径，例如 "/home/username" (Mac/Linux) 或 "C:\\Users\\username" (Windows)。
                "HOME": "<your_home_directory>"
            }
        }
    }
}

如果您是在本地开发和调试服务器，可以使用如下配置：

{
  "mcpServers": {
    "massive": {
      // MCP 服务器的启动命令。
      // 确保替换为您的 uv 安装的完整路径，例如 "/home/username/.cargo/bin/uv"
      "command": "<path_to_your_uv_install>/uv",
      // 传递给启动命令的参数。
      // "--with" 指定项目的根目录路径，"mcp_massive" 是要运行的 Python 包名。
      "args": [
        "run",
        "--with",
        "/your/path/mcp_massive", // 替换为您的 mcp_massive 仓库的本地路径
        "mcp_massive"
      ],
      // 服务器运行所需的环境变量。
      "env": {
        // 您的 Massive.com API 密钥，请替换为真实密钥。
        "MASSIVE_API_KEY": "your_api_key_here",
        // 您的主目录路径，例如 "/home/username" (Mac/Linux) 或 "C:\\Users\\username" (Windows)。
        "HOME": "/Users/yourusername" // 替换为您的主目录
      }
    }
  }
}

基本使用方法 一旦服务器配置并运行，您就可以通过支持 MCP 协议的 LLM 客户端（如 Claude）与之交互，提出问题来获取金融数据：
- “获取苹果公司 (AAPL) 股票的最新价格。”
- “告诉我微软公司 (MSFT) 昨天的交易量。”
- “今天股票市场最大的赢家是谁？”
- “获取 BTC-USD 的最新加密货币市场数据。”
- “查询通用汽车 (GM) 公司的最新财报。”

关键词

信息