Massive.com MCP 服务器

一个 模型上下文协议 (MCP) 服务器，通过对 LLM 友好的接口提供对完整的 Massive.com 金融数据 API 的访问。

该服务器没有为每个端点公开一个工具，而是为 LLM 提供了三个可组合的工具——search（搜索）、call（调用）和 query（查询）——涵盖了整个 Massive.com API 表面。数据可以存储在内存中的 SQLite 数据库中，并使用内置的金融函数进行丰富。

工具

内置函数

函数可以通过 call_api 和 query_data 上的 apply 参数应用于 API 结果或查询输出。使用 scope="functions" 的 search_endpoints 来发现它们。

数据覆盖范围

服务器在启动时从 llms.txt 动态索引所有 Massive.com API 端点，因此它会自动与 API 保持同步。覆盖范围包括：

• 股票、期权、外汇、加密货币和期货聚合数据

• 实时和历史交易及报价

• 市场快照、涨跌幅榜

• 股票代码详情和参考数据

• 股息、拆股、IPO

• 金融基本面

• 分析师评级和新闻 (Benzinga)

• 国债收益率、通胀数据

• 市场状态和节假日

Related MCP server: Dingo MCP Server

安装

先决条件

• Python 3.12+

• Massive.com API 密钥

• Astral UV (v0.4.0+)

Claude Code

首先，安装 Claude Code

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

安装 MCP 服务器，然后将其注册到 Claude Code：

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

以后升级到新版本：

uv tool upgrade mcp_massive

此命令将在您当前的项目中安装 MCP 服务器。 如果您想全局安装它，可以使用 -s <scope> 标志运行该命令。 有关更多选项，请参阅 claude mcp add --help。

要启动 Claude Code，请在终端中运行 claude。

• 如果这是您第一次使用，请按照设置提示进行身份验证

如果 MCP 服务器已经为 Claude Desktop 安装，您也可以运行 claude mcp add-from-claude-desktop。

Claude Desktop

1. 按照 Claude Desktop MCP 安装说明 完成初始安装并找到您的配置文件。

2. 安装服务器：

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

3. 找到安装的二进制文件路径：

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. 将服务器添加到您的 Claude Desktop 配置中。将 <path_to_mcp_massive> 替换为上一步的输出，并填写其余字段。

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

配置

环境变量

传输

默认使用 STDIO 传输。传输可以通过 --transport CLI 参数或 MCP_TRANSPORT 环境变量设置（CLI 参数优先）。

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

使用示例

集成后，您可以提示 Claude 访问 Massive.com 数据：

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

开发

本地运行

检查以确保您已安装 先决条件。

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

从您的本地检出安装，然后直接引用二进制文件：

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

调试

对于调试和测试，我们建议使用 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

这将启动一个浏览器界面，您可以在其中直接与您的 MCP 服务器交互，并查看每个工具的输入/输出。

在浏览器 UI 中选择 STDIO 传输类型，并使用 uv 和 run mcp_massive 作为参数。

代码 Linting

该项目使用 just 进行常见的开发任务。在提交 PR 之前对代码进行 lint：

just lint

这将运行 ruff format 和 ruff check --fix 以自动格式化您的代码并修复 linting 问题。

链接

• Massive.com 文档

• 模型上下文协议

• MCP Python SDK

隐私政策

此 MCP 服务器与 Massive.com 的 API 交互以获取市场数据。所有数据请求均受 Massive.com 的隐私政策和服务条款约束。

• Massive.com 隐私政策: https://massive.com/legal/privacy

• 数据处理: 此服务器不存储或缓存任何用户数据。所有请求都直接代理到 Massive.com 的 API。

• API 密钥: 您的 Massive.com API 密钥仅用于验证对他们 API 的请求。

• User-Agent: API 请求包含一个包含 MCP 服务器版本（例如 MCP-Massive/0.x.y）的 User-Agent 字符串。不包含任何个人身份信息。

贡献

如果您发现了错误或有新功能的想法，请先通过提交新问题与我们讨论。 我们将在最多 3 周内回复问题。 如果您想为任何未解决的问题提交 PR，我们也欢迎志愿者，但请事先与我们讨论。 未链接到现有问题或未事先与我们讨论的 PR 通常会被拒绝。