Kleros Court MCP

🚀 Kleros MCP 服務器

Kleros MCP 服務器是一個模型上下文協議（MCP）服務器，可從多個區塊鏈網絡中檢索全面的 Kleros 法庭爭議數據，包括元證據和證據提交信息。

✨ 主要特性

• 🔗 多鏈支持：支持以太坊主網和 Gnosis 鏈。
• 📊 全面的數據：提供元證據、證據提交信息和 IPFS 內容。
• 🌐 支持遠程託管：具備可流式傳輸的 HTTP 傳輸和會話管理功能。
• 🔒 安全可靠：具備 DNS 重綁定保護和適當的 CORS 配置。
• ⚡ 快速高效：可並行檢索 IPFS 內容，並能處理錯誤。
• 📱 與 Claude 桌面版兼容：可直接集成 URL。

📦 支持的網絡

• 以太坊主網（鏈 ID：1）
• Gnosis 鏈（鏈 ID：100）

📦 數據源

• 元證據 API：提供 Kleros 爭議元數據。
• 以太坊子圖：提供以太坊上的證據提交信息。
• Gnosis 子圖：提供 Gnosis 鏈上的證據提交信息。
• IPFS 網關：通過 Kleros CDN 獲取證據內容。

📚 Claude 桌面版集成

簡易設置（推薦）

1. 打開 Claude 桌面版設置
   • 點擊側邊欄中的“設置”。
2. 進入連接器設置
   • 導航至“設置”→“連接器”。
3. 添加自定義連接器
   • 點擊“添加自定義連接器”。
   • 輸入名稱：Kleros Court。
   • 粘貼 URL：https://kleros-mcp-server-new.fly.dev/mcp。
   • 點擊“添加”。

4. 開始使用
   • Kleros Court 工具現在將在 Claude 桌面版中可用。
   • 嘗試輸入：“Get dispute data for dispute ID 481 on Gnosis Chain”。

替代配置文件方法

在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "kleros": {
      "url": "https://kleros-mcp-server-new.fly.dev/mcp"
    }
  }
}

💻 使用示例

基礎用法

get_dispute_data

此方法用於從 Kleros 檢索全面的爭議數據，包括元證據和證據提交信息。

參數：

• disputeId（字符串）：要檢索數據的爭議 ID。
• chainId（數字）：鏈 ID（以太坊為 1，Gnosis 鏈為 100）。

示例用法：

• “Get dispute data for dispute ID 123 on Ethereum”
• “Show me details for dispute 481 on Gnosis Chain”
• “Retrieve evidence for dispute 50 on chain 100”

示例響應：

# Kleros 爭議數據

**爭議 ID**：481
**鏈**：Gnosis 鏈 (100)

## 元證據
**標題**：Web3 安全審計員註冊表
**描述**：一個經過篩選的已驗證安全審計員註冊表...

## 證據提交 (3)

### 證據 1
**標題**：挑戰理由
**描述**：Pokémon 不是 Web3 審計員，拒絕該提交。
**類型**：text/plain

🚀 快速開始

前提條件

• Node.js 18.x 或更高版本
• npm 或 yarn

本地開發

1. 克隆項目並安裝依賴：

git clone <your-repo>
cd kleros-mcp-server
npm install

2. 構建項目：

npm run build

3. 啟動服務器：

npm start

4. 健康檢查：

curl http://localhost:8080/health

開發模式

若要在開發過程中實現自動重啟，可使用以下命令：

npm run dev

🚀 部署

Fly.io 部署

1. 安裝 Fly CLI：

curl -L https://fly.io/install.sh | sh

2. 登錄 Fly：

fly auth login

3. 創建應用（如有需要，可在 fly.toml 中更新應用名稱）：

fly apps create kleros-mcp-server-new

4. 構建並部署：

npm run build
fly deploy

5. 檢查部署情況：

fly status
fly logs

你的 MCP 服務器將可通過以下 URL 訪問：https://kleros-mcp-server-new.fly.dev/mcp

環境變量

設置所需的環境變量：

fly secrets set ALLOWED_HOSTS=your-domain.com

📚 詳細文檔

API 端點

健康檢查

GET /health

返回服務器狀態和時間戳。

MCP 協議

POST /mcp
GET /mcp（用於 SSE 通知）
DELETE /mcp（用於會話終止）

主要的 MCP 協議端點，具備會話管理功能。

架構

kleros-mcp-server/
├── src/
│   ├── index.ts              # 具備可流式傳輸 HTTP 傳輸的 Express 服務器
│   ├── server.ts             # MCP 服務器設置和工具註冊
│   ├── services/
│   │   ├── disputeService.ts # 主要的爭議數據協調
│   │   ├── metaEvidenceService.ts # 元證據 API 集成
│   │   ├── subgraphService.ts     # 子圖查詢
│   │   └── ipfsService.ts         # IPFS 內容檢索
│   ├── types/
│   │   └── index.ts          # TypeScript 類型定義
│   └── utils/
│       └── constants.ts      # API 端點和配置
├── Dockerfile                # 容器配置
├── fly.toml                  # Fly.io 部署配置
└── package.json

錯誤處理

服務器具備全面的錯誤處理功能：

• 網絡超時：外部 API 設置 10 - 15 秒的超時時間。
• IPFS 故障：可優雅處理無法訪問的內容。
• 子圖錯誤：查詢失敗時提供詳細的錯誤報告。
• 輸入驗證：對爭議 ID 和鏈 ID 進行適當的驗證。

開發

添加新鏈

1. 在 src/types/index.ts 中的 SUPPORTED_CHAIN_IDS 中添加鏈 ID。
2. 在 src/utils/constants.ts 中的 API_ENDPOINTS.SUBGRAPHS 中添加子圖 URL。
3. 在 src/utils/constants.ts 中的 NETWORK_NAMES 中添加網絡名稱。

測試

測試爭議數據檢索：

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_dispute_data",
      "arguments": {
        "disputeId": "123",
        "chainId": 1
      }
    },
    "id": 1
  }'

MCP 檢查器合規性

此服務器通過了所有 MCP 檢查器的檢查：

• ✅ 正確的協議實現
• ✅ 正確的消息格式
• ✅ 標準的錯誤代碼
• ✅ 會話管理
• ✅ 資源清理

安全

• 啟用 DNS 重綁定保護。
• 配置適當的 CORS。
• 使用非根容器用戶。
• 進行輸入驗證和清理。
• 優雅處理錯誤，避免信息洩露。

故障排除

常見問題

1. 404 子圖錯誤：檢查子圖 URL 是否為最新版本。
2. IPFS 超時：證據內容可能暫時不可用。
3. 無效的爭議 ID：確保爭議在指定鏈上存在。

獲取幫助

• 在倉庫中創建問題。
• 查看日誌：fly logs（針對已部署版本）。
• 驗證健康狀態：curl https://kleros-mcp-server-new.fly.dev/health

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

1. 分叉倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建拉取請求。

🛠️ 支持

如有問題或疑問：

• 在倉庫中創建問題。
• 查看日誌：fly logs（針對已部署版本）。
• 驗證健康狀態：curl https://kleros-mcp-server-new.fly.dev/health