Polygon-io MCP 服务器

[！重要的]
:test_tube: 该项目处于实验阶段，可能会发生重大变化。

Polygon.io MCP 服务器

模型上下文协议 (MCP)服务器通过 LLM 友好界面提供对Polygon.io金融市场数据 API 的访问。

概述

该服务器将所有 Polygon.io API 端点公开为 MCP 工具，提供对综合金融市场数据的访问，包括：

股票、期权、外汇和加密货币集合和条形图
实时和历史交易和报价
市场概况
股票代码详情和参考数据
股息和分割数据
财务基本面
市场状况和假期

安装

先决条件

Python 3.10+
Polygon.io API 密钥
星光紫外线
- 对于现有安装，请检查您是否有一个支持uvx命令的版本。

克劳德·科德

首先，安装Claude Code

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

使用以下命令将 Polygon MCP 服务器添加到您的本地环境。此命令假设uvx位于您的 $PATH 中；如果不在，则需要提供uvx的完整路径。

# Claude CLI
claude mcp add polygon -e POLYGON_API_KEY=your_api_key_here -- uvx --from git+https://github.com/polygon-io/mcp_polygon@v0.1.0 mcp_polygon

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

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

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

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

克劳德桌面

按照Claude Desktop MCP 安装说明完成初始安装并找到您的配置文件。
参考以下示例添加 Polygon 的 MCP 服务器。请确保填写所有字段。
1. 路径找到你的uvx路径，在你的终端中运行which uvx 。
2. 将<your_api_key_here>替换为您实际的 Polygon.io API 密钥。
3. 将<your_home_directory>替换为您的主目录路径，例如/home/username (Mac/Linux) 或C:\Users\username (Windows)。

{
    "mcpServers": {
        "polygon": {
            "command": "<path_to_your_uvx_install>/uvx",
            "args": [
                "--from",
                "git+https://github.com/polygon-io/mcp_polygon@v0.1.0",
                "mcp_polygon"
            ],
            "env": {
                "POLYGON_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

使用示例

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

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

可用工具

该 MCP 服务器将所有 Polygon.io API 端点实现为工具，包括：

get_aggs - 特定股票代码的股票汇总（OHLC）数据
list_trades - 历史交易数据
get_last_trade - 某个符号的最新交易
list_ticker_news - 最新新闻文章
get_snapshot_ticker - 股票代码的当前市场快照
get_market_status - 当前市场状况和交易时间
list_stock_financials - 基本财务数据
还有更多...

每个工具都遵循 Polygon.io SDK 参数结构，同时将响应转换为 LLM 可以轻松处理的标准 JSON。

发展

本地运行

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

# Sync dependencies
uv sync

# Run the server
POLYGON_API_KEY=your_api_key_here uv run mcp_polygon

  "mcpServers": {
    "polygon": {
      "command": "/your/path/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "/your/path/mcp_polygon",
        "mcp_polygon"
      ],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here",
        "HOME": "/Users/danny"
      }
    }
  }

调试

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

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

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

链接

贡献

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

Polygon-io MCP Server