Prediction Market MCP

🚀 預測市場MCP

預測市場MCP（Model Context Protocol）服務器，可從多個平臺提供即時的預測市場數據。該服務器允許你通過統一接口查詢預測市場的當前賠率、價格和市場信息。

🚀 快速開始

預測市場MCP服務器能讓你輕鬆從多個平臺獲取即時預測市場數據。只需按照以下步驟操作，即可快速搭建並使用該服務器。

✨ 主要特性

• 多平臺支持：可查詢加密貨幣和傳統預測市場。
• 即時數據：從活躍市場獲取當前賠率和價格。
• 關鍵詞搜索：通過特定關鍵詞或主題過濾市場。
• 統一接口：不同平臺的數據格式一致。
• 錯誤處理：優雅處理API故障和網絡問題。
• 類型安全：全面支持TypeScript，具備完善的類型定義。

📦 安裝指南

前提條件

• Node.js（v18 或更高版本）
• npm 或 yarn

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd prediction-markets-mcp

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

💻 使用示例

啟動服務器

啟動MCP服務器：

node build/index.js

服務器在標準輸入輸出上運行，可與兼容MCP的客戶端集成。

API端點

服務器提供一個工具：get-prediction-markets

參數

• keyword（字符串，必需）：用於過濾市場的搜索詞
  • 最大長度：50 個字符
  • 示例："trump"、"election"、"supreme court"

查詢示例

// 搜索與特朗普相關的市場
{
  "keyword": "trump"
}

// 搜索選舉市場
{
  "keyword": "election"
}

// 搜索最高法院相關市場
{
  "keyword": "supreme court"
}

響應格式

服務器以以下格式返回預測市場數據：

Polymarket市場

**Polymarket: 特朗普會贏得2024年大選嗎？**
是: 45.2% | 否: 54.8%

PredictIt市場

**PredictIt: 哪個政黨會贏得2025年弗吉尼亞州州長選舉？**
民主黨: 89.0% | 共和黨: 11.0%

📚 詳細文檔

數據源

Polymarket API

• 基礎URL：https://clob.polymarket.com/markets
• 格式：JSON
• 賠率顯示：百分比（例如，65.2%）
• 數據：市場問題、活躍狀態、代幣價格

PredictIt API

• 基礎URL：https://www.predictit.org/api/marketdata/all/
• 格式：JSON
• 賠率顯示：美元金額（例如，$0.65）
• 數據：市場名稱、合約、交易價格、狀態

開發

項目結構

prediction-markets-mcp/
├── src/
│   └── index.ts          # 主服務器實現
├── build/                # 編譯後的JavaScript輸出
├── package.json          # 依賴項和腳本
├── tsconfig.json         # TypeScript配置
└── README.md            # 本文件

關鍵組件

類型定義

// Polymarket類型
type Market = {
  question: string;
  active: boolean;
  archived: boolean;
  tokens: Token[];
};

// PredictIt類型
type PredictItMarket = {
  id: number;
  name: string;
  shortName: string;
  contracts: PredictItContract[];
  status: string;
};

核心函數

• getPolymarketPredictionData()：獲取並處理Polymarket數據
• getPredictItMarkets()：獲取所有PredictIt市場
• makeApiRequest()：使用適當的請求頭處理HTTP請求

構建

# 開發構建
npm run build

# 監聽模式（如有需要）
npm run dev

測試

要手動測試服務器：

1. 啟動服務器：

node build/index.js

2. 通過MCP客戶端發送測試請求或直接測試API端點。

故障排除

常見問題

未找到市場

• 原因：關鍵詞過於具體或沒有匹配的市場
• 解決方案：嘗試更寬泛的關鍵詞或檢查市場可用性
• 示例：使用 "election" 代替 "特定候選人姓名"

開發設置

1. 分叉倉庫
2. 創建功能分支
3. 進行更改
4. 如有必要添加測試
5. 提交拉取請求

代碼風格

• 所有新代碼使用TypeScript
• 遵循現有的命名約定
• 為公共函數添加JSDoc註釋
• 提交前確保所有構建通過

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE 文件。

支持

如果你遇到問題或有疑問：

1. 查看故障排除部分
2. 查看現有的GitHub問題
3. 創建一個包含詳細信息的新問題