Polygon.io MCP Server

重要

:test_tube: 此项目处于实验阶段，可能会发生不兼容的变更。

Massive.com MCP 服务

一个 Model Context Protocol (MCP) 服务，通过便于大模型使用的接口，提供对完整 Massive.com 金融数据 API 的访问。

此服务不会为每个端点单独提供一个工具，而是向大模型提供三个可组合的工具——搜索、调用和查询，覆盖 Massive.com API 的全部功能。数据可存储在内存中的 SQLite 数据库中，并可使用内置金融函数进行增强。

提示

不想安装任何内容？Massive 在 https://mcp.massive.com 上托管了此服务。 请参阅 AI Tools 快速入门，了解如何在各客户端中进行设置。

工具

内置函数

可通过 call_api 和 query_data 的 apply 参数，将函数应用于 API 结果或查询输出。使用 search_endpoints 并设置 scope="functions" 来查找这些函数。

数据覆盖范围

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

• 股票、期权、外汇、加密货币和期货汇总数据
• 实时和历史交易与报价
• 市场快照、涨幅榜／跌幅榜
• 股票代码详情和参考数据
• 股息、拆股、IPO
• 财务基本面数据
• 分析师评级和新闻（Benzinga）
• 国债收益率、通胀数据
• 市场状态和节假日

安装

前提条件

• 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/[email protected]"

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

之后升级到新版本：

uv tool upgrade mcp_massive

说明

从 uvx 或 uv run --with 升级？ 之前的版本建议使用 uvx --from ... mcp_massive 或 uv run --with。这些命令会在每次冷启动时下载依赖项，这可能导致服务超出 Claude 的 30 秒连接超时。请切换到上面所示的 uv tool install，它只需下载一次依赖项，之后即可立即启动。

此命令会在当前项目中安装 MCP 服务。 如果要全局安装，可以使用 -s <scope> 标志运行该命令。 如需了解更多选项，请参阅 claude mcp add --help。

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

• 如果这是你首次使用，请按照设置提示完成身份验证

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

Claude Desktop

1. 按照 Claude Desktop MCP 安装说明完成初始安装并找到配置文件。
2. 安装服务：

uv tool install "mcp_massive @ git+https://github.com/massive-com/[email protected]"

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 服务交互，并查看每个工具的输入和输出。

在浏览器界面中选择 STDIO 传输类型，并将 uv 设为命令、将 run mcp_massive 设为参数。

代码检查

本项目使用 just 执行常见开发任务。提交 PR 前，请对代码进行检查：

just lint

这会运行 ruff format 和 ruff check --fix，自动格式化代码并修复代码检查问题。

链接

• Massive.com 文档
• Model Context Protocol
• 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 请求会包含一个 User-Agent 字符串，其中包含 MCP 服务版本（例如，MCP-Massive/0.x.y）。其中不包含任何个人身份信息。

贡献

如果您发现了错误或有新功能的想法，请先提交一个新 issue 与我们讨论。 我们最迟会在 3 周内回复 issue。 如果您想为任何未解决的 issue 提交 PR，我们也欢迎志愿者，但请事先与我们讨论。 未关联现有 issue 或未提前与我们讨论的 PR 通常会被拒绝。