djd-agent-score

djd-agent-score-mcp

DJD Agent Score 用の MCP サーバーです。Base 上の AI エージェントウォレット向けレピュテーションスコア API を提供します。

このサーバーは DJD Agent Score REST API を Model Context Protocol ツールとして公開するため、MCP 互換のエージェント（Claude、GPT、Gemini、LangChain など）はスコアリングエンドポイントをネイティブに呼び出せます。

ツール

ツール	エンドポイント	費用	説明
score_basic	GET /v1/score/basic	無料	基本スコア、ティア、信頼度
score_full	GET /v1/score/full	$0.10（x402）	全ディメンションの内訳
score_refresh	GET /v1/score/refresh	$0.25（x402）	最新のチェーンデータで再スコアリング
report_fraud	POST /v1/report	$0.02（x402）	不正レポートを送信
check_blacklist	GET /v1/data/fraud/blacklist	$0.05（x402）	不正レポートを確認
get_badge	GET /v1/badge/{wallet}.svg	無料	埋め込み可能な SVG バッジ
get_leaderboard	GET /v1/leaderboard	無料	スコア上位のウォレット
register_agent	POST /v1/agent/register	無料	メタデータとともにウォレットを登録
health_check	GET /health	無料	システムの状態

インストール

npm install -g djd-agent-score-mcp

または、npx で直接実行します。

npx djd-agent-score-mcp

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}

Cursor

プロジェクトルートの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}

Claude Code

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}

汎用 MCP クライアント（ストリーミング可能な HTTP）

HTTP モードでサーバーを起動します。

TRANSPORT=http PORT=3000 npx djd-agent-score-mcp

次に、MCP クライアントを http://localhost:3000/mcp に接続します。

環境変数

変数	デフォルト値	説明
DJD_BASE_URL	https://djd-agent-score.fly.dev	API のベース URL（ローカル開発では http://localhost:3001 を使用）
DJD_TIMEOUT_MS	10000	リクエストのタイムアウト（ミリ秒）
TRANSPORT	stdio	トランスポートモード：stdio または http
PORT	3000	HTTP サーバーのポート（TRANSPORT=http の場合のみ使用）

開発

git clone <repo-url>
cd djd-agent-score-mcp
npm install
npm run build
npm start

開発中にローカル API を指定するには、次のようにします。

DJD_BASE_URL=http://localhost:3001 npm start

x402 決済

一部のエンドポイントでは x402 マイクロペイメントが必要です。エージェントが有料ツールを呼び出すと、API は HTTP 402 と決済手順を返します。エージェントのフレームワークは、次の処理に対応している必要があります。

1. 402 レスポンスを検出する
2. x402 決済（Base 上の USDC）を完了する
3. 決済証明を付けてリクエストを再試行する

MCP サーバーは、エージェントが処理できるように、402 の詳細をツールのエラーレスポンスに含めます。

ライセンス

MIT