用途
awesome-mcp-tools-mcp 用于从终端或 MCP 客户端检索 awesome-mcp.tools 目录中的 2000 多个 MCP（Model Context Protocol）服务器。它把目录搜索能力同时提供给命令行用户和各类 MCP 客户端。
主要能力
该 npm 包包含两个组件：
- awesome-mcp CLI：在终端搜索 2000 多个 MCP 服务器。纯 Node 18+，零依赖。
- awesome-mcp-bridge：极简的 stdio↔Streamable-HTTP MCP 代理，约 100 行、零依赖。让仅支持 stdio 的 MCP 客户端（如 Claude Desktop、旧版 Cline）连接托管在 https://awesome-mcp.tools/mcp 的服务器。它从 stdin 读取 JSON-RPC，转发到该地址，并将响应流式返回，会话 ID 自动管理。
两者共用同一后端 awesome-mcp.tools。目录每 6 小时从开源生态刷新一次。
使用方式
MCP 桥接
将配置粘贴到对应客户端配置文件：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json
或使用 Claude Desktop 的 Settings → Connectors → Add custom connector，填入 URL https://awesome-mcp.tools/mcp（仅较新版本支持）。
Cursor 原生支持远程 URL，无需桥接，配置位于 ~/.cursor/mcp.json。
Codex 追加到 ~/.codex/config.toml。
Cline 在 VS Code 面板的 cline_mcp_settings.json 中配置。
Windsurf 配置位于 ~/.codeium/windsurf/mcp_config.json。
可直接粘贴的副本位于仓库的 examples/ 目录。
验证托管端点
无需安装即可验证，或使用原始 curl。
覆盖桥接目标
使用 AWESOME_MCP_URL=https://your-mirror/mcp awesome-mcp-bridge 可覆盖桥接目标，适用于自托管或测试。
适用场景
- 在终端快速搜索 MCP 服务器。
- 将 awesome-mcp.tools 的托管 MCP 服务器接入 Claude、Cursor、Codex、Cline、Windsurf 等客户端。
- 让仅支持 stdio 的客户端通过桥接访问 Streamable-HTTP 服务器。
限制与说明
- 托管服务器后端（Go API、摄取爬虫、SSR、OG 图像生成）为独立的专有代码库，不在本仓库中。本仓库仅包含：awesome-mcp CLI 源码、awesome-mcp-bridge 的 stdio→HTTP 代理源码、客户端配置示例、以及用于离线参考的实时 tools/list 响应快照。
- 后端提供的目录数据是开放的：每个服务器条目保留其上游许可证。后端代码不开源。
- 传输协议为 Streamable HTTP（MCP 规范 2025-06-18）。
- 认证：无（免费，无 API 密钥）。
- 服务器卡片：
/.well-known/mcp/server-card.json。 - 底层 REST API：
/api/docs（OpenAPI 3.0）。 - 完整输入/输出 schema 见实时 tools/list 端点，离线快照见
tools.json，传输元数据见服务器卡片。 npm test运行 CLI 库测试（Node 18+ 下 6 项通过）。桥接目前仅有针对生产环境的手动冒烟测试（将 JSON-RPC initialize 管道传入bin/awesome-mcp-bridge.js）；基于 mock 的单元测试计划在 v0.2.1 提供。- 生产就绪：awesome-mcp.tools 已上线、受监控、每 6 小时刷新。问题反馈：github.com/adw0rd/awesome-mcp-tools-mcp/issues。
