ShellWire

ShellWire MCP 与 Agent 集成

适用于 ShellWire 的官方模型上下文协议（MCP）客户端配置、可安装的 Agent 技能，以及公开 HTTP API 文档。

ShellWire 将实用软件展示在首页，并通过可解释的排名和发现功能，帮助用户和 AI 助手探索软件。按所要解决的问题，探索 AI 助手、聊天机器人、开发者工具和日常软件；比较有日期来源支持的已记录功能；查看每个应用的效用分数计算方式。

仓库范围： ShellWire 是一项托管服务（https://shellwire.com/），其应用代码库为私有。本公开仓库包含官方 MCP Registry 清单（server.json）、客户端设置指南、Agent 技能（skills/shellwire/SKILL.md），以及用于将 AI 助手和 HTTP 客户端连接到 ShellWire 的 OpenAPI 规范（openapi.json）。

关键链接

• 网站： https://shellwire.com/
• 助手连接页面： https://shellwire.com/connect
• 托管 MCP 端点（Streamable HTTP）： https://shellwire.com/mcp
• 官方 MCP Registry ID： io.github.Kiragu-Maina/shellwire（Registry 记录）
• 排行榜： https://shellwire.com/leaderboard
• 提交应用： https://shellwire.com/submit

---

快速连接（MCP）

ShellWire 在 https://shellwire.com/mcp 提供远程 Streamable HTTP MCP 服务。公开发现、工具比较和新闻读取均可匿名使用，无需 API 密钥或登录。

Claude Code

claude mcp add --transport http shellwire https://shellwire.com/mcp

Cursor / VS Code / Windsurf（mcp.json）

{
  "mcpServers": {
    "shellwire": {
      "type": "http",
      "url": "https://shellwire.com/mcp"
    }
  }
}

OpenCode（opencode.json）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shellwire": {
      "type": "remote",
      "url": "https://shellwire.com/mcp",
      "enabled": true
    }
  }
}

已认证的构建者配置（可选）

如果你的 Agent 要提交应用或查看你的私人提交状态，请提供通过第一方电子邮件 OTP HTTP 流程获取的 8 小时构建者 Bearer 令牌（见下文的构建者身份验证）：

{
  "mcpServers": {
    "shellwire": {
      "type": "http",
      "url": "https://shellwire.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SHELLWIRE_BUILDER_TOKEN}"
      }
    }
  }
}

---

MCP 工具参考（8 个工具）

公开发现工具（匿名）

工具	标题	输入参数	描述
search	搜索 ShellWire	{ "query": "string (max 200 chars)" }	搜索公开应用、聊天机器人目录和已标注的新闻。最多返回 24 个稳定 ID（tool:<uuid> 或 news:<uuid>）、标题和规范引用 URL。
fetch	读取公开记录	{ "id": "tool:<uuid> | news:<uuid>" }	获取由 search 返回的一个公开记录 ID。包含可引用文本、结构化元数据和带日期的证据来源。
compare_tools	比较聊天机器人和工具	{ "ids": ["tool:<uuid>", "..."] }（1 到 4 个 ID）	并排比较 1 到 4 个不同的公开工具 ID。保留未知事实、来源证据和核查日期，不生成评分。
get_chatbot_brief	读取聊天机器人简报	{ "limit": 4 }（可选，1 到 4）	读取 ShellWire 首页展示的经来源审阅的简报，最多包含 4 条已标注的报道（reporting、discussion、analysis）和相关公开工具。
get_submission_instructions	读取构建者提交说明	{}	返回匿名且无需凭据的说明，介绍如何进行已认证的私人提交，包括准确的 HTTP OTP 端点、限定范围的提交字段和二进制图片上传规则。

构建者提交工具（需要 Email OTP Bearer 令牌）

工具	输入参数	描述
verify_homepage_backlink	{ "officialUrl": "https://example.com" }	验证你的公开 HTTPS 网站根主页上是否存在指向 https://shellwire.com/ 的可见原生 HTML 锚点。缓存 5 分钟。
submit_application	{ "name", "officialUrl", "description", "email"?, "details"?, "images"? }	在验证主页反向链接后，提交应用或个人 AI Agent，供运营人员私下审核。对于规范化 URL 相同的重复待处理提交，系统会予以确认，但不会创建重复记录。
list_my_submissions	{}	仅返回已通过身份验证的构建者账户的私有提交状态（pending、accepted、rejected）、可选的已发布工具 URL，以及已上传图片的预览。

---

构建者身份验证（Email OTP）

ShellWire 使用一方 Email OTP Bearer 令牌执行构建者写入操作。不使用标准 OAuth，因此仅支持 URL 的 OAuth 客户端必须先通过 HTTPS 获取 Bearer 令牌，才能使用经过身份验证的写入工具。

1. 申请 6 位 OTP 验证码：

   curl -X POST https://shellwire.com/api/directory/account/agent/send-code \
     -H "Content-Type: application/json" \
     -d '{"email": "[email protected]"}'
   

2. 将验证码兑换为有效期 8 小时的 Bearer 令牌： 从你已授权的邮箱中读取 6 位验证码（或向人类用户索取），然后通过 HTTPS 兑换：

   curl -X POST https://shellwire.com/api/directory/account/agent/token \
     -H "Content-Type: application/json" \
     -d '{"email": "[email protected]", "code": "123456"}'
   

   响应：

   {
     "access_token": "<token>",
     "token_type": "Bearer",
     "expires_in": 28800,
     "user": {
       "id": "<uuid>",
       "email": "[email protected]"
     }
   }
   

3. 可选的二进制截图上传（最多 4 张图片，每张最大 5 MiB）： 发送原始二进制字节（image/png、image/jpeg 或 image/webp；不支持 multipart 或 base64）：

   curl -X POST https://shellwire.com/api/directory/media \
     -H "Authorization: Bearer ${SHELLWIRE_BUILDER_TOKEN}" \
     -H "Content-Type: image/png" \
     --data-binary @screenshot.png
   

4. 验证反向链接并通过 MCP 提交： 确保你的根主页包含指向 https://shellwire.com/ 的可见链接，调用 verify_homepage_backlink，然后调用 submit_application。
5. 完成后撤销令牌：

   curl -X POST https://shellwire.com/api/directory/account/agent/revoke \
     -H "Authorization: Bearer ${SHELLWIRE_BUILDER_TOKEN}"
   

---

公共 REST 目录 API

除 MCP 外，ShellWire 还在 https://shellwire.com/api/directory 下提供公开 JSON 端点（完整规范见 openapi.json）：

• GET /api/directory/status - 服务和 MCP 可用性状态
• GET /api/directory/tools - 搜索和筛选已发布的工具（q、category、kind、free、capability、limit、offset）
• GET /api/directory/tools/:slug - 按 slug 获取已发布的工具记录，包含带日期的证据和能力
• GET /api/directory/categories - 列出目录分类及工具数量
• GET /api/directory/leaderboard - 获取可解释的启发式排行榜（q、category、limit），并显示各因素的得分明细
• GET /api/directory/brief - 获取主页聊天机器人的新闻简报
• GET /api/directory/compare?ids=<uuid1>,<uuid2> - 并排比较最多 4 个已发布的工具
• GET /api/directory/search?q=<query> - 在工具和带标签的新闻中进行统一搜索
• GET /api/directory/records/:id - 获取公开记录（tool:<uuid> 或 news:<uuid>）及可引用文本

安装为 Agent Skill

此代码仓库包含标准 Agent Skill，位于 skills/shellwire/SKILL.md：

npx skills add Kiragu-Maina/shellwire-mcp

许可证

此代码仓库中的文档、架构、配置示例和 Agent Skill 文件均根据 MIT License 发布。