djd-agent-score

djd-agent-score-mcp

DJD Agent Score 的 MCP 服务——为 Base 上的 AI Agent 钱包提供声誉评分 API。

此服务将 DJD Agent Score REST API 暴露为 Model Context Protocol 工具，因此任何兼容 MCP 的 Agent（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 客户端（Streamable 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 小额支付。当 Agent 调用付费工具时，API 会返回 HTTP 402 和支付说明。你的 Agent 框架必须：

1. 检测 402 响应
2. 完成 x402 支付（Base 上的 USDC）
3. 使用支付凭证重试请求

MCP 服务会在工具的错误响应中提供 402 详情，以便 Agent 进行处理。

许可证

MIT