Discover Exceptional MCP Servers

MCPSvr

由社区驱动的目录，用于发现、评审和贡献 MCP 服务。

中文说明

MCPSvr 是一个轻量级的 Model Context Protocol 服务网络目录。它帮助开发者浏览可用服务、了解各服务的配置方式，并通过拉取请求贡献新条目。

该仓库以精心整理的 public/servers.json 注册表为核心，让 5ire 等 MCP 客户端可以直接安装并运行受支持的服务。

https://github.com/user-attachments/assets/3d1ec8db-2041-4f2d-b72c-eb8ae17ab31c

目录

• 为什么选择 MCPSvr
• 你可以做什么
• 项目结构
• 本地运行
• 如何添加服务
• 服务架构
• 参数占位符
• 贡献须知

为什么选择 MCPSvr

MCP 服务正在快速增长，但优质的发现渠道仍然分散。MCPSvr 为整个生态提供了一个简单的共享注册表，包含足够的元数据，方便用户评估工具，也便于客户端自动完成设置。

你可以做什么

• 在一个可浏览的目录中发现 MCP 服务
• 查看运行时命令、参数、环境变量和主页链接
• 通过拉取请求贡献新服务或完善现有元数据
• 在支持直接安装的 MCP 客户端中复用该注册表

项目结构

.
├── app/                # Next.js app router pages
├── components/         # Reusable UI components
├── lib/                # Utility helpers
├── public/
│   ├── logo.png
│   └── servers.json    # Central MCP server registry
└── README_cn.md        # Chinese README

本地运行

前提条件

• Node.js 18+
• npm（或其他与 package-lock.json 兼容的包管理器）

安装

npm install

启动开发服务

npm run dev

然后打开 http://localhost:3000。

构建生产版本

npm run build
npm run start

如何添加服务

所有已注册的 MCP 服务都维护在 public/servers.json 中。要贡献新条目：

1. Fork 此仓库
2. 在 public/servers.json 中添加或更新服务对象
3. 保持键的顺序一致
4. 提交拉取请求，并附上项目主页或文档链接

服务架构

{
  "name": "Server Identifier",
  "key": "Unique alphanumeric identifier",
  "description": "Concise implementation overview",
  "command": "Execution environment specifier (for example uvx, npx, python, node)",
  "args": [
    "Required runtime arguments"
  ],
  "env": {
    "ENVIRONMENT_VARIABLE": "Value assignment"
  },
  "homepage": "Official documentation URL"
}

字段指南

• key 必须唯一，由字母数字字符组成，并以字母开头
• name 为可选项；省略时会回退为 key
• env 和 homepage 为可选项，但强烈建议填写
• 描述应简短实用，方便客户端清晰展示

参数占位符

当服务需要用户提供输入时，请使用以下占位符格式：

{{paramName@paramType::paramDescription}}

示例：

{
  "name": "File System Access Control",
  "key": "FileSystem",
  "command": "npx",
  "description": "Enforces directory-level operation restrictions through specified arguments",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "{{dirs@list::directories you are about to access, include trailing slash}}"
  ],
  "homepage": "https://github.com/modelcontextprotocol/servers"
}

支持的占位符类型包括 string、list 和 number。

贡献须知

• 优先提供准确的元数据，而非营销文案
• 提交前仔细检查命令参数
• 尽可能附上主页或文档链接
• 如果将来添加新字段，请确保架构与下游客户端保持向后兼容