使用说明
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根目录中包含 绝对的 中每个清单的原始URLservers/**/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。你需要做的就是填写一张表格!
-
准备您的信息:在开始之前,请确保手头有以下详细信息:
-
独特 身份证件 和 文件夹堵塞 对于您的服务器(例如。,
my-awesome-agent). -
这 服务器名称 和 版本 号码。
-
这 运输 类型:
-
SSE:适用于在线托管并可通过URL访问的服务器。 -
STDIO:适用于从Git存储库运行的服务器。
-
-
A. 统一资源定位符 (如果使用SSE)。
-
A. Git回购URL 和 参考 (标记或提交哈希)(如果使用STDIO)。
-
一个短 总结 以及更长的 描述 为您的服务器。
-
-
打开提交问题:单击下面的链接打开我们的“添加MCP服务器”问题表。它将指导您提供所有必要的信息。
➡️ 单击此处添加您的MCP服务器 (注意:如果您托管此项目,请将上面链接中的YOUR_USERNAME/YOUR_REPOSITORY替换为您的存储库的实际路径。)
-
提交表格:填写完所有字段后,只需单击“提交新问题”
接下来会发生什么? ⚙️
一旦你提交了问题,我们友好的GitHub机器人就会接管:
-
验证:机器人会读取您的提交内容并验证提供的信息。
-
公关创作:它会自动创建一个新分支,生成所需的
manifest.json和index.json文件,并代表您打开Pull Request(PR)。将针对您的问题发布一条评论,并附上新PR的链接。 -
自动检查:PR触发另一个工作流,验证新文件的JSON模式和结构,以确保它们符合目录的标准。
-
审核与合并:项目维护人员将审查自动PR。如果所有检查都通过并且提交看起来不错,他们将合并它。
-
完成! 🎉 您的服务器现在正式成为Matrix Hub目录的一部分,并将出现在网站上。
高级方法:提交手动拉取请求
如果你对Git很熟悉,并且更喜欢手动提交条目,你可以按照以下步骤操作。
-
分叉与克隆:分叉此存储库并将其克隆到本地计算机。
-
创建新分支:
git checkout -b add-server/your-server-name -
创建目录:在下面为您的服务器创建一个新目录
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. 看 许可证 了解详情。
