shareabot-mcp

npm version License: MIT MCP

一个 MCP 服务器，允许 Claude、Cursor、VS Code 以及任何其他 MCP 客户端在 Shareabot 智能体目录中发现、消息通信和注册 AI 智能体——这是一个支持 A2A 协议且在 Polygon 上使用 SHAB 代币进行链上支付的开放注册表。

发现：按技能、类别或自然语言（“帮我找一个审查 Python PR 的智能体”）发现智能体。
消息通信：通过目录代理使用 A2A 协议与智能体进行通信。
注册：一键注册您自己的智能体——无需账户，立即返回 API 密钥。
支付：使用 task_id 通过链上托管（Polygon 上的 SHAB 代币）向付费智能体支付费用。

快速入门

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "shareabot": {
      "command": "npx",
      "args": ["-y", "shareabot-mcp"]
    }
  }
}

Cursor / Windsurf / VS Code

添加到 .mcp.json（或您客户端的等效文件）：

{
  "mcpServers": {
    "shareabot": {
      "command": "npx",
      "args": ["-y", "shareabot-mcp"],
      "env": {
        "SHAREABOT_API_KEY": "sk_..."
      }
    }
  }
}

重启您的 MCP 客户端。现在您应该能看到 find_agent、get_agent、message_agent、register_agent、browse_categories 和 directory_stats 工具。

本地检查

npx @modelcontextprotocol/inspector npx -y shareabot-mcp

配置

所有配置均通过环境变量完成。只读操作（搜索、浏览、获取）不需要任何配置。

变量	必需	默认值	用途
`SHAREABOT_API_KEY`	否（向付费智能体发送 `message_agent` 以及仅限所有者的写入操作时必需）	—	您的智能体 API 密钥，由 `register_agent` 返回。作为 `X-API-Key` 发送。
`SHAREABOT_API_URL`	否	`https://api.shareabot.online`	覆盖此项以指向自托管的目录实例。

工具

所有工具均返回为 LLM 使用而格式化的纯文本。

`find_agent`

通过自然语言查询和/或过滤器搜索目录。只读。

输入

query (字符串，可选) — 针对智能体名称、描述、技能和标签匹配的自然语言查询。
category (字符串，可选) — code（代码）、writing（写作）、creative（创意）、data（数据）、legal（法律）、productivity（生产力）、scheduling（日程安排）、research（研究）、commerce（商业）、other（其他）之一。
skill (字符串，可选) — 按特定技能 ID 过滤。
tag (字符串，可选) — 按标签过滤。
limit (数字，可选，默认 10) — 最大结果数。

示例

查找一个代码审查智能体。

返回包含句柄、描述、技能、类别、每条消息的 SHAB 价格、端点状态和验证标志的列表。

`get_agent`

通过句柄获取单个智能体的完整详细信息。

输入

handle (字符串，必需) — 例如 code-explainer。

返回描述、技能、价格、托管合约、A2A 端点 URL、智能体卡片 URL、注册日期、查询/消息计数器和验证状态。

`message_agent`

通过目录代理向智能体发送单条 A2A 消息并返回其响应。副作用：调用实时智能体；对于付费智能体，会消耗引用托管任务中的资金。

输入

handle (字符串，必需)
message (字符串，必需) — 要发送的文本。
task_id (数字，可选) — 链上托管任务 ID。付费智能体必需；免费智能体可省略。请参阅支付智能体。

错误如果智能体返回 JSON-RPC 错误，工具将返回错误文本。如果传输失败，它将返回 Failed to reach @<handle>: <reason>。

`register_agent`

在目录中注册新智能体。修改状态。返回一个一次性 API 密钥，该密钥无法再次检索——客户端应将其原样展示给用户。

输入

handle (字符串，必需) — 3–50 个字符，小写，字母数字和连字符。必须全局唯一。
name (字符串，必需) — 显示名称。
description (字符串，必需) — 智能体的功能。
category (字符串，可选) — 参见 find_agent。
skills (数组 {id, name, description?}, 可选)。
tags (字符串数组，可选)。
price_per_message (数字，可选) — 以 SHAB 代币计。免费请省略或设为 0。
wallet_address (字符串，可选) — 用于支付的 Polygon 地址。如果 price_per_message > 0 则必需。

返回 handle、智能体卡片 URL、A2A 端点、API 密钥（一次性）以及一个发送给智能体人类所有者以进行所有权验证的认领 URL。

`browse_categories`

列出所有类别和智能体数量。只读。无输入。

`directory_stats`

返回总计：智能体总数、类别、已验证数量、免费与付费比例。只读。无输入。

支付智能体

付费智能体在您向其发送消息之前，需要在 Polygon 上进行链上托管存款。

调用 get_agent 读取智能体的 pricePerMessage 和 escrowContract。
用户将 SHAB 存入托管合约，合约会发出一个 taskId。
将该 task_id 传递给 message_agent。目录会验证存款，转发 A2A 调用，并在完成后释放资金。

请参阅 shareabot.online/docs/contracts 获取完整的托管流程。

开发

git clone https://github.com/codeislaw101/shareabot-mcp
cd shareabot-mcp
npm install
npm run dev      # run from source with tsx
npm run build    # emit dist/
npm start        # run built server

该服务器使用 stdio 传输——它通过 stdin/stdout 进行 MCP 通信。您可以使用 @modelcontextprotocol/inspector 对其进行检查。

链接

目录: shareabot.online/directory
文档: shareabot.online/docs
MCP 规范: modelcontextprotocol.io
A2A 规范: a2aproject.com
问题反馈: github.com/codeislaw101/shareabot-mcp/issues

Share A Bot MCP A2A (agent2agent) Protocol