如何向awesome-remote-mcp-servers提交你的MCP服务器?贡献流程、CI校验与Glama徽章全解析
如何向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`
[](https://glama.ai/mcp/connectors/com.example/name)
🔐 - One sentence describing what the tools do.
逐行拆解:
- 名称 + 主页:名称链接到产品官网或文档页(不是代码仓库链接),因为远程服务器本质上是托管服务
- 端点地址:用反引号包裹,必须与用户粘贴到客户端中的地址完全一致
- Glama connector 徽章(第 2 行):格式见下一节
- 标记符 + 一句话描述:以句点结尾,最多 120 字符
认证标记符怎么选?
每条提交都必须标注认证方式(定义见 CONTRIBUTING.md):
| 标记 | 含义 |
|---|---|
| 🔓 | 无需认证,匿名连接 |
| 🔑 | 需要 API key 或 token |
| 🔐 | 使用 OAuth 认证 |
Glama 徽章全解析:质量分 + 健康度,缺一不可
Glama connector 徽章是上榜的必备项(CONTRIBUTING.md)。它的作用是向读者展示:
- 📊 工具定义质量(tool definition quality)
- ❤️ 端点健康度——让读者一眼分辨出活跃维护的服务器和被弃置的服务器
获取徽章的步骤:
- 到 Glama 的 connector 目录(glama.ai/mcp/connectors)提交你的服务器
- 等它显示出来后,你的徽章代码为:
[](https://glama.ai/mcp/connectors/NAMESPACE/NAME)
- 其中
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 了 ⭐