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，請刪除虛擬環境並創建一個新的虛擬環境。