如何向awesome-remote-mcp-servers提交你的MCP服务器?贡献流程、CI校验与Glama徽章全解析

原创2026-10-14 17:52:231,629 阅读

如何向awesome-remote-mcp-servers提交你的MCP服务器?贡献流程、CI校验与Glama徽章全解析

awesome-remote-mcp-servers 是一个精选的**远程 MCP 服务器(Remote MCP Server)**目录清单:收录的都是由服务方托管、通过 URL 直接连接、无需本地安装的 MCP 端点。想让自己的服务器上榜?这篇文章带你一次看懂完整贡献流程、CI 自动校验机制和 Glama 徽章规则,照着做就能一次通过 PR 审核 🎯

第一步:确认你的服务器符合上榜条件

不是所有 MCP 服务器都能进这个清单。根据官方贡献指南 CONTRIBUTING.md,提交对象必须同时满足 4 个硬性条件:

条件 说明
🌐 公网可达 端点必须能响应 MCP 的 initialize 握手请求,CI 会在每个 PR 上实际验证
👥 任何人可用 公开注册可以,但仅限邀请、私有或单租户的端点不收
📡 传输协议 必须支持 Streamable HTTP 或 SSE,需要本地进程的服务器不属于本清单范围
🏅 已列入 Glama connector 每个条目都必须携带 Glama connector 徽章,没有徽章的 PR 不会被合并

⚠️ 需要为每个用户提供独立端点 URL 的服务器、或在付费墙后无法完成握手的服务,都不在收录之列。

如果 CI 检查与你的条目不一致,官方建议是修改条目而不是绕过检查(见 CONTRIBUTING.md)。

条目标准格式:3 行搞定一条提交

清单中每个服务器只占 3 行,格式严格统一(示例见 README.md):

- [Name](https://homepage.example) `https://mcp.example.com/mcp`
  [![Name MCP connector](https://glama.ai/mcp/connectors/com.example/name/badges/score.svg)](https://glama.ai/mcp/connectors/com.example/name)
  🔐 - One sentence describing what the tools do.

逐行拆解:

  1. 名称 + 主页:名称链接到产品官网或文档页(不是代码仓库链接),因为远程服务器本质上是托管服务
  2. 端点地址:用反引号包裹,必须与用户粘贴到客户端中的地址完全一致
  3. Glama connector 徽章(第 2 行):格式见下一节
  4. 标记符 + 一句话描述:以句点结尾,最多 120 字符

认证标记符怎么选?

每条提交都必须标注认证方式(定义见 CONTRIBUTING.md):

标记 含义
🔓 无需认证,匿名连接
🔑 需要 API key 或 token
🔐 使用 OAuth 认证

Glama 徽章全解析:质量分 + 健康度,缺一不可

Glama connector 徽章是上榜的必备项(CONTRIBUTING.md)。它的作用是向读者展示:

  • 📊 工具定义质量(tool definition quality)
  • ❤️ 端点健康度——让读者一眼分辨出活跃维护的服务器和被弃置的服务器

获取徽章的步骤:

  1. 到 Glama 的 connector 目录(glama.ai/mcp/connectors)提交你的服务器
  2. 等它显示出来后,你的徽章代码为:
[![NAME MCP connector](https://glama.ai/mcp/connectors/NAMESPACE/NAME/badges/score.svg)](https://glama.ai/mcp/connectors/NAMESPACE/NAME)
  1. 其中 NAMESPACE/NAME 是 connector 的反向域名标识符(reverse-DNS),例如 io.tseha/tseha

🚨 重点提醒:CI 会验证 connector 是否真实存在,徽章指向一个不存在的 connector 会直接校验失败;缺少徽章的 PR 一律不予合并。

五步贡献流程:从 Star 到 Pull Request

完整流程记录在 CONTRIBUTING.md,照做即可:

第 1 步:Star 仓库 ⭐(必须!)

这是硬性要求——开 PR 的账号如果没给仓库点 Star,PR 不会被合并,很多新手栽在这一步。

第 2 步:Fork 仓库,先克隆到本地:

git clone https://gitcode.com/gh_mirrors/awes/awesome-remote-mcp-servers

第 3 步:创建分支

git checkout -b add-example-server

第 4 步:编辑 README.md,按上面的 3 行格式添加你的条目。

第 5 步:提交并发起 PR,在 PR 描述中说明你的服务器是做什么的。

🤖 自动化代理的快捷通道

如果你的提交来自自动化 Agent,只需在 PR 标题末尾加上 🤖🤖🤖 即可加入快速合并通道,你的 PR 会被 fast-track 处理(CONTRIBUTING.md)。

排错指南:提交前自查清单

检查项 常见问题
⭐ 已 Star 仓库? 未 Star 的 PR 直接不予合并
🏅 徽章存在且 connector 有效? 徽章指向缺失 connector 会导致 CI 失败
📝 描述 ≤ 120 字符且以句点结尾? 超长或无句点都会被要求修改
🔤 按字母顺序插入分类? 分类内按不区分大小写的字母序排列
🔢 一个服务器只占一条? 同一服务商有多个端点时(如 Cloudflare),每个端点单独列出
📑 新建分类了吗? 需同步更新 README 顶部的目录索引,且保持与正文相同的顺序

排序与分类规则详见 CONTRIBUTING.md。

遇到卡点怎么办?

  • 在 PR 下直接留言提问
  • 加入项目官方的 Discord 社区寻求帮助(入口见 README.md)
  • 再次核对 CONTRIBUTING.md 的完整规则,项目遵循 LICENSE 许可条款

掌握「4 个上榜条件 + 3 行条目格式 + Glama 徽章 + 5 步流程」,你的远程 MCP 服务器离上榜只差一个 Star 了 ⭐

登录后查看全文
awesome-remote-mcp-servers