AI代理查询服务器

ERC-8004 MCP服务器是一个用于查询AI代理身份的模型上下文协议服务器,支持通过The Graph子图查询链上数据并获取IPFS元数据以获取完整的链下详细信息。

  • by wpank
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 wpank/erc-8004-mcp-server

使用说明

ERC-8004 MCP服务器

用于查询ERC-8004 AI代理身份的MCP(模型上下文协议)服务器。它查询The Graph子图以获取链上数据,并获取IPFS元数据以获取完整的链下详细信息。

特性

  • 搜索代理 按名称与可选协议过滤(MCP/A2A)
  • 列出代理 具有分页、排序和协议过滤功能
  • 获取完整的代理详细信息 包括合同状态、服务、身份和统计信息
  • 获取反馈/评论 带有分数、标签、复习文本和MCP/A2A上下文
  • 获取参与度统计数据 标签分析和分数分布
  • 获取完整元数据 包括链下IPFS属性(认证、型号信息、社交链接、定价等)

工具

工具 说明
search_agents 使用可选协议筛选器按名称搜索代理
list_agents 通过分页和排序浏览代理
get_agent 按ID获取代理的完整详细信息
get_agent_feedback 获取代理的所有反馈/评论
get_agent_stats 获取参与度指标和得分明细
get_agent_metadata 获取完整的链上+链下元数据(IPFS)

设置

yarn install

用法

stdio模式(克劳德桌面、光标等)

yarn dev

HTTP模式(流式HTTP)

yarn dev:http

服务器启动于 http://localhost:3100/mcp 默认情况下。设置 PORT 环境变量来改变它。

生产

yarn build
yarn start          # stdio
yarn start:http     # HTTP

使用Claude Desktop进行配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "erc-8004-agents": {
      "command": "npx",
      "args": ["tsx", "/path/to/erc-8004-mcp-server/src/index.ts"]
    }
  }
}

或者使用编译版本:

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

使用光标进行配置

添加到光标MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "erc-8004-agents": {
      "command": "npx",
      "args": ["tsx", "/path/to/erc-8004-mcp-server/src/index.ts"]
    }
  }
}

或者对于HTTP传输:

{
  "mcpServers": {
    "erc-8004-agents": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

查询示例

连接后,您可以询问您的AI助手:

  • “在ERC-8004上搜索健身器材”
  • “列出最近创建的具有MCP支持的代理”
  • “获取代理11155111:1213的详细信息”
  • “给我看龙虾拉里的所有反馈”
  • “代理11155111:1213的完整元数据属性是什么?”
  • “给我看看这位经纪人的统计数据和得分明细”

数据源

  • 链上数据: ERC-8004子图 在Sepolia测试网上
  • 链下元数据:通过公共网关实现IPFS(IPFS.io、cloudflare-IPFS.com、dweb.link)