Kleros Court MCP

🚀 Kleros MCP Server

Kleros MCP Serverは、複数のブロックチェーンネットワークからメタエビデンスやエビデンス提出を含む、包括的なKleros裁判所の紛争データを取得する、Model Context Protocol (MCP) サーバーです。

✨ 主な機能

• 🔗 マルチチェーン対応：イーサリアムメインネットとGnosis Chain
• 📊 包括的なデータ：メタエビデンス、エビデンス提出、およびIPFSコンテンツ
• 🌐 リモートホスティング対応：セッション管理付きのストリーミング可能なHTTPトランスポート
• 🔒 セキュア：DNSリバインディング保護と適切なCORS設定
• ⚡ 高速：エラーハンドリング付きの並列IPFSコンテンツ取得
• 📱 Claude Desktop互換：直接URLを統合可能

📦 サポートされるネットワーク

• イーサリアムメインネット (chainId: 1)
• Gnosis Chain (chainId: 100)

📦 データソース

• メタエビデンスAPI：Kleros紛争メタデータ
• イーサリアムサブグラフ：イーサリアム上のエビデンス提出
• Gnosisサブグラフ：Gnosis Chain上のエビデンス提出
• IPFSゲートウェイ：Kleros CDN経由のエビデンスコンテンツ

📚 Claude Desktop統合

簡単なセットアップ（推奨）

1. Claude Desktopの設定を開く

   • サイドバーの「設定」をクリック

2. コネクターに移動

   • 設定 → コネクターに移動

3. カスタムコネクターを追加

   • 「カスタムコネクターを追加」をクリック
   • 名前を入力：Kleros Court
   • URLを貼り付け：https://kleros-mcp-server-new.fly.dev/mcp
   • 「追加」をクリック

4. 使用を開始
   • Kleros CourtツールがClaude Desktopで利用可能になります
   • 試してみてください：「Gnosis Chain上の紛争ID 481の紛争データを取得」

代替の設定ファイル方法

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)

使用例:

• "イーサリアム上の紛争ID 123の紛争データを取得"
• "Gnosis Chain上の紛争481の詳細を表示"
• "チェーン100上の紛争50のエビデンスを取得"

サンプルレスポンス:

# Kleros紛争データ

**紛争ID:** 481
**チェーン:** Gnosis Chain (100)

## メタエビデンス
**タイトル:** Web3セキュリティ監査員レジストリ
**説明:** 検証済みのセキュリティ監査員の精選レジストリ...

## エビデンス提出 (3件)

### エビデンス1
**タイトル:** 異議申し立ての正当化
**説明:** ポケモンは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：指定されたチェーン上に紛争が存在することを確認してください。

ヘルプの取得

• サーバーのヘルスを確認する：curl https://kleros-mcp-server-new.fly.dev/health
• ログを確認する：fly logs（デプロイされたバージョンの場合）
• ローカルでテストする：npm run dev

📄 ライセンス

MIT

🤝 コントリビューション

1. リポジトリをフォークします。
2. あなたの機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

🛠️ サポート

問題や質問がある場合は：

• リポジトリにイシューを作成してください。
• ログを確認する：fly logs（デプロイされたバージョンの場合）
• ヘルスを確認する：curl https://kleros-mcp-server-new.fly.dev/health