MCP-dump

它是什么？

Agent MCP Registry 是一个不断扩充的集合，收录了独立编写文档的模型上下文协议实现和集成模式，供开发者探索 Agent 与工具的接口、服务和客户端如何协同工作。目前最完善的路径是一个 Python FastMCP 服务，可将文件操作限制在配置的工作区内。

仓库还包含独立的电子邮件验证 MCP、TypeScript Cloudflare Worker、Gemini 和 LangGraph 客户端示例，以及一个依赖外部 Postgres MCP 服务的 Azure OpenAI Agent。这些示例并不构成一个可部署的应用程序，其成熟度也各不相同。

随着目录不断扩充，条目、运行时和集成可能会发生变化。每个条目都有独立的文档，以便清楚了解其当前功能和限制。

目录规划

目录通过自包含的条目不断扩充，让用户可以轻松查看、调整或替换每种集成思路。未来的条目可能涵盖本地和托管服务、客户端模式、工具安全、评估辅助工具和部署方式。

只有已提交到仓库并附有文档的实现才会列为可用。下方目录是仓库当前内容的准确信息来源。

快速开始

最简洁的自包含路径是启动 Python 文件服务。它需要 Python 3.13 或更高版本和 `uv`。

```bash git clone https://github.com/jayanth-mkv/agent-mcp-registry.git cd agent-mcp-registry/mcp-files uv sync uv run mcp-server --help uv run mcp-server ```

服务通过 SSE 监听 `127.0.0.1:8000`，并默认将工具限制在 `workspace/` 内。需要时可覆盖这些值：

```bash uv run mcp-server --host 0.0.0.0 --port 9001 --workspace ./data ```

CLI 还提供 `http` 和 `stdio` 传输方式。该服务没有身份验证层，因此不要将其暴露给不受信任的网络。

电子邮件验证 MCP

独立的 `mcp-email-validator` 服务会检查语法和 DNS 邮件路由，但不会发送电子邮件。SMTP 收件人探测默认禁用，且仅应针对你有权评估的地址和基础设施启用。

```bash cd mcp-email-validator uv sync uv run mcp-email-validator --transport stdio ```

当前目录

路径	状态	代码实现内容
mcp-files/mcp-server	已实现，实验性	FastMCP 服务，提供 14 个文件、目录、搜索、元数据和工作区统计工具。
mcp-email-validator	已实现，实验性	FastMCP 服务，用于检查语法、DNS 邮件路由，以及在有限范围内选择性检查 SMTP 收件人。
mcp-files/examples/clients	实验性	面向本地 SSE 服务的普通 FastMCP、Gemini 和 LangGraph 客户端示例。
mcp-hello	已实现，实验性	Cloudflare Worker 方法，用于问候和获取当前时间，并通过 workers-mcp 路由。
mcp-postgres	实验性，依赖服务	Azure OpenAI ReAct Agent，从单独托管的 Postgres MCP 端点加载工具。
mcp-files/mcp-hello	文档占位	Worker 示例说明；TypeScript 实现本身位于仓库根目录。

Python 文件工具

本地服务实现以下功能：

• 创建、读取、覆盖、追加、复制、移动、重命名和删除路径。
• 列出文件和目录、搜索文本文件，并检查路径是否存在。
• 以 JSON 格式返回文件元数据和汇总的工作区统计信息。
• 拒绝解析到已配置工作区之外的路径。

delete_path 会递归删除该工作区内的目录。请将对服务的访问视为对已配置目录的写入权限。

可选 Agent 客户端

先启动文件服务，然后在运行任一 Google 支持的示例之前设置 GOOGLE_API_KEY：

cd mcp-files
uv run examples/clients/gemini.py
# or
uv run examples/clients/react_agent.py

Postgres 示例另需 Azure OpenAI 凭据和 MCP_RENDER_URL；它不包含或启动其连接的 Postgres MCP 服务。

架构

目录中的每个条目都选择了不同的入口点和传输方式，但实现的流程方向相同：调用方访问 MCP 边界，调用该条目提供的工具，并接收特定于运行时的结果。

成熟度与差距

此注册表仍在完善中，并非有版本号的产品。在基于它进行开发之前，请注意以下已提交代码中的不一致：

• mcp-files/examples/clients/base.py 使用 filename 调用 create_file，而服务工具要求使用 path。
• Cloudflare Worker 测试仍断言初始响应 Hello World!；当前 Worker 则通过 ProxyToSelf 委托处理请求。
• 没有可用于安装、运行或测试所有实验的根目录命令。
• 部分嵌套文档描述的文件实际上位于仓库的其他位置。

限制

• 文件服务没有身份验证、授权策略、配额或自动化测试。
• 邮件验证服务不能保证邮箱所有权或邮件可送达；SMTP 探测是可选的、范围有限，并可能受到全收件箱策略或反滥用行为影响。
• 文本工具假定文件使用 UTF-8 编码，并非为二进制文件或超大文件设计。
• Gemini、LangGraph、Azure OpenAI、Postgres MCP 和 Cloudflare 路径需要外部凭据或服务。
• Postgres 示例没有本地依赖清单，因此无法仅从该文件夹复现其环境。
• mcp-files/ 和 mcp-email-validator/ 包含各自的许可证文件；仓库根目录目前未说明整个集合的复用条款。

开发

TypeScript 示例在 `mcp-hello/package.json` 中声明了检查项：

```bash cd mcp-hello npm ci npm test -- --run ```

在将该测试命令视为通过的验证关卡之前，请先更新过时的 Worker 断言。新的 Python 工具应添加到 `tools.py`，并应针对路径限制和破坏性操作编写有针对性的测试。