Polygon.io MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端实现,它将 Polygon.io 丰富的金融市场数据 API 功能封装成 MCP 工具,供支持 MCP 的大型语言模型 (LLM) 客户端调用。

项目简介

该项目由 Polygon.io 官方开发和维护,旨在为 LLM 提供一个标准化的方式来获取实时和历史的股票、期权、外汇、加密货币等金融市场数据。

主要功能点

  • 丰富的金融工具: 将 Polygon.io API 的各类数据查询功能(如获取行情、历史K线、交易、报价、公司财报、新闻等)暴露为易于 LLM 调用的工具。
  • 多样化的数据支持: 覆盖股票、期权、外汇、加密货币等多种资产类别的数据。
  • 标准化接口: 遵循 MCP 协议,通过 JSON-RPC 与 LLM 客户端通信,确保数据访问和功能调用的标准化和互操作性。

安装步骤

该 MCP 服务器通常作为 LLM 客户端(如 Anthropic Claude Code/Desktop)的一个插件或扩展来安装。具体的安装流程依赖于您使用的 MCP 客户端。一般来说,您需要:

  1. 确保您的系统安装了 Python 3.10+。
  2. 获取一个 Polygon.io API Key。
  3. 安装支持从 Git 仓库安装 MCP 服务器的工具,例如 Astral UV 的 'uvx' 命令。
  4. 使用客户端提供的命令行工具或图形界面,通过指向此 GitHub 仓库的 URL 和指定的版本号 ('v0.1.0') 来添加服务器。安装过程中需要配置您的 Polygon.io API Key。

请参考您使用的 MCP 客户端的官方文档获取最准确的安装指令。

服务器配置

在大多数 MCP 客户端中,您需要通过一个配置文件(通常是 JSON 格式)来注册 Polygon.io MCP 服务器。配置信息会包含一个标识符(例如 'polygon')、启动服务器进程所需的命令 ('command') 和参数 ('args'),以及可能需要的环境变量 ('env'),特别是您的 'POLYGON_API_KEY'。

以下是配置的关键信息,您需要将其填写到您的 MCP 客户端配置文件中:

  • 服务器名称 (server name): 例如 "polygon"
  • 启动命令 (command): 指向您系统中安装的 'uvx' 工具的可执行路径。
  • 命令参数 (args):
    • '"--from"': 指定安装源类型。
    • '"git+https://github.com/polygon-io/[email protected]"': 指定服务器的 Git 仓库 URL 和版本号。
    • '"mcp_polygon"': 指定要运行的 Python 模块名称。
  • 环境变量 (env): 必须包含 'POLYGON_API_KEY',其值设置为您的 Polygon.io API Key。

请将上述信息填写到您的 MCP 客户端配置文件的正确位置和格式中。

基本使用方法

服务器成功安装并配置到您的 MCP 客户端后,您就可以在与 LLM 交互时,通过自然语言指令来访问 Polygon.io 的数据。例如:

  • "获取苹果 (AAPL) 股票最新的收盘价。"
  • "帮我查找微软 (MSFT) 股票昨天的交易量。"
  • "请列出今天美国股票市场涨幅最大的几个股票。"
  • "获取 BTC-USD 货币对的最新市场快照。"

LLM 客户端会识别这些指令,并通过 MCP 协议调用 Polygon.io MCP 服务器中对应的工具函数,然后将获取到的数据呈现给您。

信息

分类

网页与API