AI导哈

Polymarket MCP服务器

一个符合模型上下文协议（MCP）的服务器，提供Polymarket中央限价订单簿（CLOB）REST API，供LLM驱动的IDE或代理调用。

  • by CarlosIbCu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 CarlosIbCu/polymarket-mcp

使用说明

Polymarket MCP服务器

A. 模型上下文协议（MCP） 兼容服务器，将公共Polymarket Central Limit Order Book（CLOB）REST API公开为任何LLM驱动的IDE或代理都可以调用的工具。兼容 光标, 继续 （VS码）， GitHub Copilot 聊天助手, JetBrains人工智能助手, OpenAI聊天GPT（助理API）, 史密瑟里 以及任何其他MCP感知接口。

✨ 特性

  • 🪄 通用MCP支持 –适用于Cursor、Continue、Copilot、JetBrains AI、Smithery等
  • ⚡ Python实现 –使用具有异步支持的本地MCP协议
  • 📈 开箱即用的基本端点 –列出市场、获取单一市场详细信息等
  • 🔌 无状态&无需身份验证 –查询Polymarket的公共REST端点；不需要钥匙
  • 🐳 Docker就绪 –几秒钟内即可运送和部署到任何地方
  • 📝 麻省理工学院许可 –个人和商业用途免费

🚀 快速开始

地方发展

# Clone the repository
git clone https://github.com/CarlosIbCu/polymarket-mcp.git
cd polymarket-mcp

# Install dependencies
pip install -r requirements.txt

# Run the server
python -m polymarket_mcp.main

MCP检验员测试

您可以使用官方的MCP检查器测试服务器：

# Install and run the MCP Inspector
npx @modelcontextprotocol/inspector python -m polymarket_mcp.main

这将：

  1. 启动MCP服务器
  2. 启动检查器web界面
  3. 提供一个URL以访问检查员（通常http://localhost:6274)

检查员允许您：

  • 查看可用的MCP工具
  • 交互式测试工具调用
  • 检查服务器功能
  • 调试MCP协议消息

Docker部署

# Build the image
docker build -t polymarket-mcp .

# Run the container
docker run -p 3333:3333 polymarket-mcp

Smithery部署

此服务器已准备好在上部署 史密瑟里，MCP托管平台：

  1. 分叉/克隆此存储库
  2. 将您的GitHub帐户连接到Smithery
  3. 选择此存储库并选择“自定义部署”
  4. Smithery将自动检测配置并部署

这 smithery.yaml 配置包括：

  • 容器运行时设置
  • 服务器配置选项
  • 健康检查
  • 工具模式

🛠 可用工具

list_markets

列出具有可选限制参数的可用预测市场。

参数：

  • limit （整数，可选）：要返回的最大市场数（默认值：10）

例子：

{
  "limit": 5
}

get_market

获取特定市场的详细信息。

参数：

  • market_id （字符串，必填）：要获取的市场ID

例子：

{
  "market_id": "0x9deb0baac40648821f96f01339229a422e2f5c877de55dc4dbf981f95a1e709c"
}

🔧 配置

服务器配置是通过环境变量或Smithery配置来处理的：

server:
  host: "0.0.0.0"  # Server host
  port: 3333       # Server port
  timeout: 30      # Request timeout in seconds

📚 API文档

  • MCP检查员：使用 npx @modelcontextprotocol/inspector 用于交互式测试
  • Polymarket API文件: 官方文件

🧪 测试

# Test the Polymarket API connectivity
python test_server.py

# Run with MCP Inspector for interactive testing
npx @modelcontextprotocol/inspector python -m polymarket_mcp.main

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

这个项目是麻省理工学院授权的。请参阅 许可证 文件以获取详细信息。

相关 MCP