AI导哈

Polymarket预测市场协议库

为Polymarket预测市场提供MCP服务器和客户端库，支持市场浏览、订单管理和交易操作。

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

使用说明

@c0pilot/mcp聚合物市场

MCP（模型上下文协议）服务器和客户端库 多市场 预测市场。

特性

  • MCP服务器：作为AI代理的独立MCP服务器运行
  • 客户端库：导入并在您自己的项目中使用
  • 浏览和搜索预测市场
  • 查看订单簿和市场价格
  • 检查钱包余额和头寸
  • 下订单和取消订单
  • 与Polymarket的CLOB API完全集成

安装

npm install @c0pilot/mcp-polymarket

用法

作为MCP服务器

使用克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["mcp-polymarket"],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "0x...",
        "POLYMARKET_FUNDER": "0x..."
      }
    }
  }
}

独立

export POLYMARKET_PRIVATE_KEY="0x..."
export POLYMARKET_FUNDER="0x..."
npx mcp-polymarket

作为图书馆

import { ClobClientWrapper } from 'mcp-polymarket/client';
import { createConfig } from 'mcp-polymarket/config';

// Create config
const config = createConfig({
  privateKey: '0x...',
  funder: '0x...',      // optional
  readonly: false,       // optional
});

// Initialize client
const client = new ClobClientWrapper(config);
await client.initialize();

// Use the client
const clobClient = client.getClient();
const orderbook = await clobClient.getOrderBook(tokenId);

配置

环境变量

变量 必填 默认 描述
POLYMARKET_PRIVATE_KEY 是 - 用于签名的钱包私钥
POLYMARKET_FUNDER 否 派生 代理钱包地址
POLYMARKET_API_KEY 无 派生 API密钥（如果未设置则为自动派生）
POLYMARKET_API_SECRET 无 派生 API机密（如果未设置，则自动派生）
POLYMARKET_PASSPHRASE 无 派生 API密码短语（如果未设置，则为自动派生）
POLYMARKET_CHAIN_ID 否 137 多边形主网
POLYMARKET_READONLY 否 错误 禁用交易工具

查找您的资助者地址

您的“资助者”是您的Polymarket代理钱包-登录时在Polymarket.com上显示的地址。如果您通过Polymarket的UI存款，资金就在这个代理钱包中。

可用的MCP工具

只读

工具 说明
polymarket_get_markets 列出活跃的预测市场
polymarket_get_market 获取特定市场的详细信息
polymarket_get_orderbook 查看代币的订单簿
polymarket_get_balance 检查钱包USDC余额
polymarket_get_positions 查看未结订单和头寸
polymarket_get_trades 获取最近的交易历史

交易

工具 说明
polymarket_place_order 下达限价订单（买入/卖出）
polymarket_cancel_order 取消未结订单

API出口

// Main MCP server entry
import mcp from '@c0pilot/mcp-polymarket';

// Client wrapper for Polymarket CLOB
import { ClobClientWrapper } from '@c0pilot/mcp-polymarket/client';

// Configuration utilities
import { createConfig, getConfig, Config } from '@c0pilot/mcp-polymarket/config';

// Type definitions
import { MarketInfo, OrderbookInfo, Position } from '@c0pilot/mcp-polymarket/types';

安全

  • 私钥从不被记录
  • 使用 POLYMARKET_READONLY=true 安全勘探
  • 从私钥自动派生的API凭据
  • 所有参数的输入验证

发展

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run E2E tests (requires env vars)
npm run test:e2e

相关

许可证

麻省理工学院

相关 MCP