使用说明
Agent MCP Registry
A growing catalog of MCP servers, clients, and integration patterns for agent-tool systems.
Current entries are experimental samples, not a production-ready MCP distribution.
这是怎么一回事？ · 快速开始 · 当前目录 · 建筑学 · 局限性
这是怎么一回事？
Agent MCP Registry是一个不断增长的独立记录的模型上下文协议实现和集成模式的集合。它适合开发人员探索代理工具接口、服务器和客户端如何组合在一起。它最完整的当前路径是Python FastMCP服务器，它将文件操作限制在配置的工作区中。
该存储库还包含一个独立的电子邮件验证MCP、一个TypeScript Cloudflare Worker、Gemini和LangGraph客户端示例，以及一个需要外部Postgres MCP服务器的Azure OpenAI代理。这些示例并不构成一个可部署的应用程序，它们的成熟度也各不相同。
条目、运行时和集成可能会随着注册表的增长而变化。每个条目都有独立的记录，因此其当前的能力和局限性是明确的。
目录方向
注册表通过自包含的条目进行扩展，使一个集成想法易于检查、调整或替换。未来的条目可以涵盖本地和托管服务器、客户端模式、工具安全、评估助手和部署方法。
只有已签入并记录在案的实施才会显示为可用。下面的目录是存储库当前包含内容的真实来源。
快速开始
最短的自包含路径启动Python文件服务器。它需要 Python 3.13或更新版本 和 `紫外线`.
```bash 克隆https://github.com/jayanth-mkv/agent-mcp-registry.git cd代理mcp注册表/mcp文件 紫外同步 uv运行mcp服务器--帮助 uv运行mcp服务器 ```
服务器通过SSE监听“127.0.0.1:8000”，默认情况下将工具限制在“workspace/”。需要时覆盖这些值：
```bash uv运行mcp服务器——主机0.0.0.0——端口9001——工作区。/数据 ```
CLI还公开了“http”和“stdio”传输。没有身份验证层，因此不要将服务器暴露在不受信任的网络中。
电子邮件验证MCP
独立报 `mcp电子邮件验证器` 服务器在不发送电子邮件的情况下检查语法和DNS邮件路由。默认情况下，其SMTP收件人探测已禁用，应仅对您有权评估的地址和基础架构启用。
```bash cd-mcp电子邮件验证器 紫外同步 uv运行mcp电子邮件验证器--传输stdio ```
当前目录
| 路径 | 状态 | 代码实现了什么 |
|---|---|---|
| `mcp文件/mcp服务器` | 已实现的实验性 | FastMCP服务器，具有14个文件、目录、搜索、元数据和工作区统计工具。 |
| `mcp电子邮件验证器` | 实现了实验性的 | FastMCP服务器，用于语法、DNS邮件路由和有界的选择加入SMTP收件人检查。 |
| `mcp文件/示例/客户端` | 实验 | 针对本地SSE服务器的普通FastMCP、Gemini和LangGraph客户端示例。 |
| `mcp你好` | 实现了实验性的Cloudflare Worker方法，用于问候和当前时间，通过“workers mcp”路由。 | |
| `mcp postgres` | 实验性的、依赖于服务的 | Azure OpenAI ReAct代理，从单独托管的Postgres MCP端点加载工具。 |
| `mcp文件/mcp你好` | 文档存根 | Worker示例注释；TypeScript实现本身位于存储库根目录。 |
Python文件工具
本地服务器实现以下结果：
- 创建、读取、覆盖、追加、复制、移动、重命名和删除路径。
- 列出文件和目录，搜索文本文件，并检查路径是否存在。
- 以JSON格式返回文件元数据和聚合工作区统计信息。
- 拒绝在配置的工作区之外解析的路径。
`deletepath递归删除该工作区内的目录。将对服务器的访问视为对配置目录的写访问。
可选代理客户端
首先启动文件服务器，然后在运行GOOGLE支持的示例之前设置“GOOGLE_API_KEY”：
```bash cd-mcp文件 uv运行示例/clients/gemini.py
或
uv运行示例/clients/react_agent.py ```
Postgres示例分别需要Azure OpenAI凭据和`MCP_RENDER_URL`；它不包括或启动它所连接的Postgres MCP服务器。
建筑学
每个目录条目选择不同的入口点和传输，但实现的方向是相同的：调用者到达MCP边界，调用该条目提供的工具，并接收特定于运行时的结果。
成熟度和差距
此注册表仍在成熟，而不是版本化产品。在构建之前，请注意这些签入不匹配：
- `mcp files/examples/clients/base.py使用`filename`调用`createfile`，而服务器工具需要`path`。
- Cloudflare Worker测试仍然断言启动器响应“Hello World！`；当前worker改为通过“ProxyToSelf”委派请求。
- 没有安装、运行或测试每个实验的根命令。
- 一些嵌套文档描述了存储库中其他位置的文件。
局限性
- 文件服务器没有身份验证、授权策略、配额或自动测试。
- 电子邮件验证服务器不是邮箱所有权或可送达性的保证；SMTP探测是选择性的、有界的，并且可能受到全面或反滥用行为的影响。
- 文本工具采用UTF-8编码，不是为二进制或非常大的文件设计的。
- Gemini、LangGraph、Azure OpenAI、Postgres MCP和Cloudflare路径需要外部凭据或服务。
- Postgres示例没有本地依赖清单，因此其环境不能仅从该文件夹复制。
- `mcp文件/和mcp电子邮件验证器/包括它们自己的许可证文件；存储库根当前没有声明完整集合的重用术语。
发展
TypeScript示例声明了它的签入 `mcp hello/package.json`:
```bash cd mcp你好 npm ci npm测试--run ```
在将该测试命令视为通过的验证门之前，请更新过时的Worker断言。新的Python工具属于 `tools.py` 并应包括针对路径限制和破坏性操作的重点测试。
