1mcpserver

🚀 1 MCP Server

1 MCP Server 是一款能够为你挑选并配置 MCP 服务器的工具。它就像是 MCP 中的 MCP，能够在你的本地机器上自动发现并配置 MCP 服务器，还支持远程操作！我们的目标是仅提供这一个 MCP 服务器，之后你就可以将其余的所有工作（如搜索服务器、选择服务器、配置服务器等）都交给它来完成。无需运行安装命令，也无需获取 API 密钥，只需要修改一个文件即可。

演示视频：点击观看

🚀 快速开始

✨ 主要特性

• 自动发现并配置 MCP 服务器，无需手动搜索和配置。
• 支持远程操作，方便快捷。
• 无需运行复杂的安装命令，也无需获取 API 密钥。
• 提供简单的设置流程，仅需修改一个文件。

📦 安装指南

简单远程设置：与 Cursor 和 Claude 集成（选项 1）

将以下内容添加到 Cursor 或 Claude 的 MCP 配置文件中。

对于 Cursor：打开 ~/.cursor/mcp.json

对于 Claude：

• macOS：打开 ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：打开 %APPDATA%\Claude\claude_desktop_config.json

在文件中添加以下内容：

{
  "mcpServers": {
    "mcp-server-discovery": {
      "url": "https://mcp.1mcpserver.com/mcp/",
      "headers": {
        "Accept": "text/event-stream",
        "Cache-Control": "no-cache",
        "API_KEY": "value"
      }
    }
  }
}

如果你已经在使用其他服务器，JSON 文件应如下所示：

{
    "mcpServers": {
        "mcp-server-discovery": {
            "url": "https://mcp.1mcpserver.com/mcp/",
            "headers": {
                "Accept": "text/event-stream",
                "Cache-Control": "no-cache"
            }
        },
        "file-system": {
            "command": "node",
            "args": [
                "/Users/jiazhenghao/CodingProjects/MCP/filesystem/index.ts",
                "~/"
            ]
        }
    }
}

（选项 2）使用 STDIO 进行本地设置

git clone https://github.com/particlefuture/MCPDiscovery.git
cd MCPDiscovery
uv sync
uv run server.py

遗憾的是，截至此 Markdown 文件更新时，Claude 仅支持 STDIO。因此，你需要修改 server.py 以使用 STDIO。在 server.py 中找到主块，注释掉 "Streamable HTTP server BLOCK" 并取消注释 "Standard I/O server BLOCK"。最终代码应如下所示：

    asyncio.run(
        mcp.run_async(
            transport="stdio",
        )
    )

mcp.json 文件应如下所示：

{
    "mcpServers": {
        "mcp-servers-discovery": {
            "command": "/Users/jiazhenghao/.local/bin/uv",
            "args": [
                "--directory",
                "{PATH_TO_THE_CLONED_REPO}",
                "run",
                "server.py", 
               "--local"
            ]
        },
        "file-system": {
            "command": "node",
            "args": [
                "{FILE_SYSTEM_CLONED_PATH}/filesystem/index.ts",
                "~/"
            ]
        }
    }
}

🔧 技术细节

搜索工具类型

有两种类型的搜索工具：快速搜索和深度搜索。

快速搜索

当用户明确知道自己想要的 MCP 类型（例如“我想要一个处理支付的 MCP 服务器”）时，此工具会直接返回一个 MCP 服务器列表。

深度搜索 ^*

当用户对目标有高层次或复杂的描述（例如“为我构建一个分析其他网站的网站”）时，LLM 需要将其分解为多个步骤和组件（我需要分析网站流量，我需要分析网站技术栈，我需要展示一些网页数据……），然后为每个步骤找到相应的 MCP 服务器。如果相应的 MCP 服务器不存在，则通知用户，询问是忽略此组件、进一步分解它还是自行实现。

我将此称为水平扩展和垂直扩展。水平扩展用于查找独立的组件，垂直扩展用于查找必须按顺序执行的步骤（更像是获取、分析、生成图表）。在上述示例中，这些都是水平扩展。

深度搜索有多个阶段：

1. 规划阶段：
   • 设置 MCP 服务器：
     • 根据需要获取并配置 API 密钥，为用户提供获取 API 密钥的说明。
     • 修改 mcp.json 文件。
2. 测试阶段：
   • 测试服务器是否正常工作。调用 test_server_template_code 工具，该工具会返回一个简单的客户端测试代码示例。
3. 执行阶段：
   • 通过调用 MCP 服务器来构建工作流/应用程序。

*我们本应将深度搜索作为一个提示，但 Cursor 和 Claude 很少调用提示。

📄 变更日志

• 2025 年 7 月 31 日：升级到 0.2.0 版本。添加了智能规划功能。对于复杂任务，服务器现在会提示 LLM 执行多步骤 MCP 服务器查询。

未来规划

• 改进演示视频：使用新的域名、实际示例和语音解释。
• 呼吁采用 MCCP（模型上下文通信协议）：这是 MCP 服务器之间通信的标准方式。动机是允许直接向其他 MCP 服务器发送请求（每个 MCP 服务器可能也有依赖项）。（但也需要更严格的监管）
• 除非得到 MCP 服务器的指示，否则不应调用以 internal_ 开头的函数。
• 为 MCP 服务器建立更好的数据库。其结构应为：服务器、描述、URL、配置 JSON（可选，还可包含额外的设置、Docker、API 密钥等）。

项目依赖

本仓库基于以下仓库开发，非常感谢这些仓库的作者和贡献者。

• 数据源：

  • wong2/awesome-mcp-servers
  • metorial/mcp-containers
  • punkpeye/awesome-mcp-servers
  • modelcontextprotocol/servers

• 发布地址：

  • https://mcpservers.org/
  • https://glama.ai/mcp/servers

更多信息

动机和背景

目前，大多数 MCP 服务器搜索是通过 GitHub 搜索或在线谷歌搜索完成的。虽然已经有一些 MCP 包装器，但大多数只是作为一种中间件基础设施，在一个端点上托管不同的 MCP。而选择要托管哪些 MCP 仍然主要通过手动搜索完成。我们提供了一个自动管道，不仅可以搜索 MCP 服务器，还可以自动配置它们。

测试情况

已使用 Claude 和 Cursor 对远程端点和本地 STDIO 进行了测试，演示测试了 10 次。

🛠️ 故障排除

⚠️ 重要提示

如果使用虚拟环境，即使安装了模块仍出现 ModuleNotFoundError，请删除虚拟环境并创建一个新的虚拟环境。