Kleros Scout MCP Server

Kleros MCP服务器

一种模型上下文协议（MCP）服务器，用于查询来自Kleros Scout API的地址标签。Kleros Scout提供社区策划的去中心化地址标签，帮助识别多个EVM链上区块链地址的可信度和目的。

特性

• 🔍 查询多个地址：在单个请求中查找最多100个地址的标签
• 🌐 多链支持：同时跨20多个EVM链进行查询
• 📊 灵活的输出：以JSON（机器可读）或Markdown（人类可读）格式获取结果
• ✅ 已验证标签：访问社区策划和验证的地址信息
• 🛡️ 类型安全：使用TypeScript和Zod验证构建
• ⚡ MCP标准：完全符合模型上下文协议

什么是Kleros Scout？

Kleros Scout是一个去中心化的、由社区策划的注册表，提供：

• 地址标签：标识地址类型的标签（DEX、DeFi、Scam等）
• 项目名称：协议和智能合约的正式名称
• 验证状态：社区验证的真实性信息
• 元数据：描述、网站和其他背景

这有助于用户识别值得信赖的地址，并在整个区块链生态系统中避免恶意地址。

安装

# Clone or create the project directory
cd kleros-mcp-server

# Install dependencies
npm install

# Build the TypeScript code
npm run build

用法

服务器可以在两种模式下运行：

1.本地模式（stdio传输）

用于使用子流程通信与Claude Desktop进行本地使用。

# Start the local server
npm start

Claude桌面配置:

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kleros": {
      "command": "node",
      "args": [
        "/absolute/path/to/kleros-mcp-server/dist/index.js"
      ]
    }
  }
}

2.远程模式（HTTP传输）

通过HTTP/SSE进行远程访问，允许其他人使用您的服务器。

# Start the HTTP server
npm run start:http

# Or with custom configuration
PORT=3000 ALLOWED_ORIGINS=* npm run start:http

Claude桌面配置 （远程）：

{
  "mcpServers": {
    "kleros-remote": {
      "url": "https://your-server.com/mcp",
      "transport": "streamable-http"
    }
  }
}

🌐 免费远程主机：参见 部署.md 有关部署到以下位置的分步指南：

• Render.com（推荐，750小时/月免费）
• Railway.app（每月5美元）
• Fly.io（3个免费虚拟机）
• Google Cloud Run（每月200万次请求）

设置时间：约5分钟

可用工具

kleros_query_address_tags

查询跨多个链的多个地址的地址标签。

参数：

• addresses （string\[\]）：以太坊地址数组（1-100）

- 格式： 0x 后面是40个十六进制字符 - 例子： ["0xed2d13a70acbd61074fc56bd0d0845e35f793e5e"]

• chains （string\[\]）：EVM链ID数组（1-20）

- 常见链条： - "1" -以太坊主网 - "100" -Gnosis链 - "137" -多边形 - "42161" -Arbitrum One - "10" -乐观主义 - "56" -币安智能链 - "43114" -雪崩C链 - "250" -Fantom - "324" -zksync时代 - "534352" -滚动 - "59144" -Linea

• response_format （“json”|“markdown”，可选）：输出格式

- 违约： "markdown"

示例用法：

// Query a single address on Ethereum and Gnosis
{
  "addresses": ["0xed2d13a70acbd61074fc56bd0d0845e35f793e5e"],
  "chains": ["1", "100"],
  "response_format": "markdown"
}

// Query multiple addresses on multiple chains
{
  "addresses": [
    "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
    "0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC"
  ],
  "chains": ["1", "137", "42161"],
  "response_format": "json"
}

响应格式

Markdown格式

人类可读的格式，有组织的部分：

# Kleros Address Tags Query Results

**Total Results:** 2
**Query Time:** 2024-01-15T10:30:00.000Z

## Ethereum Mainnet (Chain ID: 1)

### 0xed2d13a70acbd61074fc56bd0d0845e35f793e5e

**Project:** Uniswap V3
**Tags:** DEX, DeFi, Liquidity Pool
**Description:** Uniswap V3 Router contract
**Website:** https://uniswap.org
**Verified:** ✓ Yes
**Submitted:** 2024-01-01T00:00:00.000Z

JSON格式

机器可读结构化数据：

{
  "totalResults": 2,
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "1": {
      "0xed2d13a70acbd61074fc56bd0d0845e35f793e5e": {
        "address": "0xed2d13a70acbd61074fc56bd0d0845e35f793e5e",
        "chainId": "1",
        "tags": ["DEX", "DeFi", "Liquidity Pool"],
        "projectName": "Uniswap V3",
        "description": "Uniswap V3 Router contract",
        "website": "https://uniswap.org",
        "verified": true,
        "submittedAt": "2024-01-01T00:00:00.000Z"
      }
    }
  }
}

错误处理

服务器提供清晰、可操作的错误消息：

• 地址格式无效：正确的以太坊地址格式指南
• 链ID无效：解释链ID要求
• 速率限制：建议等待重试
• 网络问题：建议检查连接
• API错误：提供有关服务状态的上下文

发展

项目结构

kleros-mcp-server/
├── src/
│   ├── index.ts              # Main server entry point
│   ├── constants.ts          # Configuration constants
│   ├── types.ts              # TypeScript type definitions
│   ├── schemas/
│   │   └── address-tags.ts   # Zod validation schemas
│   ├── services/
│   │   ├── kleros-api.ts     # API client
│   │   └── formatter.ts      # Response formatters
│   └── tools/
│       └── query-address-tags.ts  # Tool implementation
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

构建命令

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server
npm start

# Development (build + run)
npm run dev

添加新功能

要添加新工具，请执行以下操作：

1. 在中创建新文件 src/tools/
2. 在中定义Zod模式 src/schemas/
3. 实施工具处理程序
4. 注册 src/index.ts

API 参考

Kleros Scout API

基本URL: https://scout-api.kleros.link

端点: POST /api/address-tags

请求正文:

{
  "chains": ["1", "100"],
  "addresses": ["0x..."]
}

有关更多信息，请访问：

• 克莱罗斯童子军
• Kleros文件

局限性

• 每个请求最多100个地址
• 每个请求最多20个链
• 响应大小限制为25000个字符
• 适用费率限制（由API管理）

许可证

麻省理工学院

贡献

欢迎投稿！请确保：

• TypeScript严格模式合规性
• 全面的错误处理
• 更新文件
• 输入的Zod模式验证

支持

对于问题或疑问：

• Kleros文件：https://docs.kleros.io/
• Kleros Discord：https://discord.gg/kleros
• MCP文件：https://modelcontextprotocol.io/

版本历史记录

1.0.0（初始版本）

• 从Kleros Scout API查询地址标签
• 支持11+EVM链的多链
• JSON和Markdown输出格式
• 全面的错误处理
• 使用Zod验证的类型安全实现