MCP 已上线

awesome-repositories.com MCP 服务器。

将任何支持 MCP 的智能体指向 https://awesome-repositories.com/api/mcp。首次工具调用将引导您完成 Google 一键登录；之后，您的智能体即可根据意图搜索目录、阅读任何仓库并查找其文档。这是一个只读服务器——仅供搜索和阅读，无法进行写入操作。

连接服务器 — 一条命令，适配所有智能体

将服务器添加到它检测到的所有 MCP 客户端中 — 包括 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Codex、Zed、Goose、Copilot CLI 等。追加 -y 以跳过提示， -g 进行全局（用户级）安装，或 --agent <client> 以目标为准。

npx add-mcp https://awesome-repositories.com/api/mcp --name awesome-repositories

或按客户端添加

Claude Code

claude mcp add --transport http awesome-repositories https://awesome-repositories.com/api/mcp

VS Code

code --add-mcp '{"name":"awesome-repositories","type":"http","url":"https://awesome-repositories.com/api/mcp"}'

Cursor / Codex / Windsurf / Zed

npx add-mcp https://awesome-repositories.com/api/mcp --agent cursor   # or: codex · windsurf · zed · cline · goose

Claude Desktop / 其他任何客户端 — 粘贴到其 MCP 配置文件中

{
  "mcpServers": {
    "awesome-repositories": {
      "type": "http",
      "url": "https://awesome-repositories.com/api/mcp"
    }
  }
}

无需 Authorization 请求头 — 客户端会自动处理 OAuth 流程。

可选 — 安装搜索技能 (Search Skill)

通过以下知名索引，为您的每个 Agent 安装一项技能（如何解析意图以标记路径并进行有效搜索）： /.well-known/agent-skills/index.json。该技能会教导 Agent 如何驱动工具；而上述连接才是实际链接服务器的部分。

npx skills add https://awesome-repositories.com

身份验证

OAuth 2.1 — 无需粘贴令牌。客户端会自动从以下地址发现授权服务器： /.well-known/oauth-protected-resource，完成自身注册（动态客户端注册），然后打开浏览器标签页供您使用 Google 登录。刷新令牌 (Refresh tokens) 可保持会话活跃。每位已登录用户均可调用所有工具 — 这是一个只读服务器，因此无需按角色进行权限控制。

工具

均为只读。适用于任何已登录用户。

search_repositories — 混合 BM25 + AI 搜索。默认开启 AI 重排序（当每日配额用尽时会回退至 BM25）；传入 ai:false 可使用原始 BM25。可通过 filter_tag_paths 进行缩小范围搜索。
search_metadata_tags — 针对统一标签树的混合搜索 — 在过滤搜索前，将概念解析为规范的标签路径。
get_repository — 获取单个仓库的详细信息（通过内部 ID 或 owner/repo），包含标签分配和文档计数。
list_curated_searches — 管理员置顶的搜索别名 — 便捷的发现入口。
list_repository_docs — 为仓库索引的文档页面（README / 文档），每个页面均包含源 URL — 可直接从该 URL 获取页面正文。