MCP服务器注册表

Agent-Matrix Catalog是一个公开的、版本化的MCP服务器注册表,用于发布和管理MCP服务器的清单文件,支持高容量、仅追加的发布方式。

  • by agent-matrix
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 agent-matrix/catalog

使用说明

Agent-Matrix Catalog

概述

这 代理矩阵目录 是一个公共的、版本化的注册表 MCP服务器 MatrixHub使用的(代理/工具)。
它发布了一个规范 index.json 随着 绝对RAW URL 每个服务器的 manifest.json,再加上每个服务器包含一个 manifest.json 以及每个文件夹 index.json.

  • 🔗 顶级RAW索引(主分支):

此回购旨在 大, 加的 发布:通过Pull Request添加新服务器;CI刷新顶部索引。

存储库布局

.
├─ index.json                 # Top-level catalog of all manifests (absolute RAW URLs)
└─ servers/
├─ <server-folder-1>/
│  ├─ manifest.json       # MCP server manifest
│  └─ index.json          # Per-folder index (usually \["manifest.json"])
├─ <server-folder-2>/
│  ├─ manifest.json
│  └─ index.json
└─ ...
  • index.json 在repo根目录中包含 绝对的 中每个清单的原始URL servers/**/manifest.json.
  • 每 servers/<folder>/index.json 列出该文件夹中的清单,通常为:
    { "manifests": ["manifest.json"] }
    
    

索引是如何工作的

获取一个文件:

curl -s https://raw.githubusercontent.com/agent-matrix/catalog/refs/heads/main/index.json

你会得到:

{
  "manifests": [
    "https://raw.githubusercontent.com/agent-matrix/catalog/refs/heads/main/servers/<folder-a>/manifest.json",
    "https://raw.githubusercontent.com/agent-matrix/catalog/refs/heads/main/servers/<folder-b>/manifest.json"
  ]
}

每个URL都是一个完整的MCP清单,可以独立安装。

目标是创建一个丰富的生态系统,开发人员可以很容易地找到服务器来集成到他们的项目中,贡献者可以展示他们的工作。

如何创建新服务器➡️

您可以使用我们的现成模板创建一个新的简单服务器。

https://github.com/agent-matrix/mcp-template

如何添加服务器(简单方法)✨

我们创建了一个完全自动化的、由机器人驱动的提交流程,不需要你分叉存储库或使用Git。你需要做的就是填写一张表格!

  1. 准备您的信息:在开始之前,请确保手头有以下详细信息:

    • 独特 身份证件 和 文件夹堵塞 对于您的服务器(例如。, my-awesome-agent).

    • 这 服务器名称 和 版本 号码。

    • 这 运输 类型:

      • SSE:适用于在线托管并可通过URL访问的服务器。

      • STDIO:适用于从Git存储库运行的服务器。

    • A. 统一资源定位符 (如果使用SSE)。

    • A. Git回购URL 和 参考 (标记或提交哈希)(如果使用STDIO)。

    • 一个短 总结 以及更长的 描述 为您的服务器。

  2. 打开提交问题:单击下面的链接打开我们的“添加MCP服务器”问题表。它将指导您提供所有必要的信息。

    ➡️ 单击此处添加您的MCP服务器 (注意:如果您托管此项目,请将上面链接中的YOUR_USERNAME/YOUR_REPOSITORY替换为您的存储库的实际路径。)

  3. 提交表格:填写完所有字段后,只需单击“提交新问题”

接下来会发生什么? ⚙️

一旦你提交了问题,我们友好的GitHub机器人就会接管:

  1. 验证:机器人会读取您的提交内容并验证提供的信息。

  2. 公关创作:它会自动创建一个新分支,生成所需的 manifest.json 和 index.json 文件,并代表您打开Pull Request(PR)。将针对您的问题发布一条评论,并附上新PR的链接。

  3. 自动检查:PR触发另一个工作流,验证新文件的JSON模式和结构,以确保它们符合目录的标准。

  4. 审核与合并:项目维护人员将审查自动PR。如果所有检查都通过并且提交看起来不错,他们将合并它。

  5. 完成! 🎉 您的服务器现在正式成为Matrix Hub目录的一部分,并将出现在网站上。

高级方法:提交手动拉取请求

如果你对Git很熟悉,并且更喜欢手动提交条目,你可以按照以下步骤操作。

  1. 分叉与克隆:分叉此存储库并将其克隆到本地计算机。

  2. 创建新分支: git checkout -b add-server/your-server-name

  3. 创建目录:在下面为您的服务器创建一个新目录 servers/ 文件夹。该名称应该是您唯一的服务器slug。

生成/验证清单 mcp-ingest

我们推荐 mcp摄入 SDK+CLI生成一致的清单和索引。

安装

pip install mcp-ingest

描述/打包本地服务器(离线)

# Emits manifest.json + index.json
mcp-ingest pack ./path/to/server --out ./dist

鸣谢

  • 首席开发人员: 鲁斯兰·马加纳·维谢沃洛多夫娜 — https://ruslanmv.com
  • 模型上下文协议 协议和参考服务器社区。
  • Agent Matrix生态系统中的维护者和贡献者。

“由 agent-generator 和 mcp-ingest.”


许可证

本目录发布于 Apache许可证2.0. 看 许可证 了解详情。