项目简介

PolyMarket Predictions MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供访问 PolyMarket 预测市场数据的标准化接口。通过此服务器，LLM 可以便捷地获取实时的市场信息、价格动态以及历史交易数据，从而支持在金融预测、事件分析等领域的应用。

主要功能点

市场信息查询： 提供工具以获取指定预测市场的详细信息，包括市场标题、类别、状态和到期日等。
市场列表检索： 支持列出可用的预测市场，并允许根据市场状态进行筛选，以便快速定位目标市场。
实时价格获取： 提供查询工具，用于获取预测市场当前的实时价格和交易信息。
历史数据查询： 支持检索预测市场的历史价格和交易量数据，并允许用户自定义时间范围（如1天、7天、30天或全部）。

安装步骤

克隆仓库并进入目录：

git clone https://github.com/berlinbra/polymarket-mcp
cd polymarket-mcp

安装依赖库： 确保你的Python环境已安装 'uv' 包管理器，然后运行以下命令安装项目依赖：
```
uv pip install -e .
```
配置API密钥和钱包地址： 在项目根目录下创建 '.env' 文件，并填入你的 PolyMarket API 密钥和钱包地址。请替换 '你的_API_密钥' 和 '你的_PolyMarket_钱包地址' 为你的实际信息。
```
Key=你的_API_密钥
Funder=你的_PolyMarket_钱包地址
```

服务器配置

要将 PolyMarket Predictions MCP Server 配置到 MCP 客户端（例如 Claude），您需要提供服务器的启动命令和相关参数。以下是一个典型的 JSON 格式配置示例，您需要将其添加到您的 MCP 客户端配置文件中。

{
    "serverName": "polymarket-mcp",
    "command": "uv",
    "args": [
        "--directory",
        "/用户/{你的用户名}/你的/路径/到/polymarket-mcp",  // 请替换为你的 polymarket-mcp 仓库在本地的绝对路径
        "run",
        "src/polymarket_mcp/server.py"
    ],
    "env": {
        "KEY": "<你的 poly market api key>", // 可选：如果 .env 文件配置正确，此处可以省略
        "FUNDER": "<你的 polymarket wallet address>" // 可选：如果 .env 文件配置正确，此处可以省略
    }
}

配置参数说明：

'serverName': 服务器名称，例如 "polymarket-mcp"，用于在客户端中标识此服务器。
'command': 启动服务器的命令，这里使用 'uv' 包管理器来运行 Python 脚本。
'args': 传递给 'uv' 命令的参数列表：
- '--directory': 指定服务器代码所在的目录，请务必替换为 'polymarket-mcp' 仓库在你电脑上的实际路径。
- 'run': 'uv' 命令的子命令，用于运行指定的 Python 脚本。
- 'src/polymarket_mcp/server.py': 服务器主程序脚本的路径。
'env': 环境变量配置，用于传递 API 密钥和钱包地址。如果已在 '.env' 文件中配置，此处可以省略。

基本使用方法

确保已按照上述配置启动 MCP 服务器。
在 MCP 客户端中连接到配置好的 "polymarket-mcp" 服务器。
使用客户端提供的工具调用功能，例如：
- 调用 'get-market-info' 工具并提供 'market_id' 参数，获取特定市场的详细信息。
- 调用 'list-markets' 工具，根据需要提供 'status' 参数（例如 "active", "resolved"）来筛选市场。
- 调用 'get-market-prices' 工具并提供 'market_id' 参数，获取市场实时价格信息。
- 调用 'get-market-history' 工具，提供 'market_id' 和 'timeframe' 参数（例如 "1d", "7d", "30d", "all"），获取市场历史数据。
客户端将向服务器发送请求，服务器处理请求并返回预测市场数据，客户端即可利用这些数据进行后续操作。

关键词

信息