MCP Host CLI

一個基於Node.js的MCP主機應用，用於連接和管理多個MCP服務器

開發者工具人工智能聊天機器人 #MCP主機 #服務器管理 #HTTP API #工具調用 .TypeScript

評分 : 2.5分

下載量 : 19

更新時間 : 2025-04-28

什麼是MCP Host服務器?

MCP Host是一箇中間件服務器，它允許您通過簡單的HTTP API同時連接和管理多個MCP服務器。它抽象了底層連接細節，為您提供一個統一的接口來訪問不同MCP服務器提供的工具和資源。

如何使用MCP Host服務器?

您可以通過簡單的HTTP請求與MCP Host交互，它會自動管理底層與各個MCP服務器的連接。您只需要配置好要連接的MCP服務器信息，剩下的工作都由Host處理。

適用場景

當您需要同時使用多個MCP服務器提供的功能時；當您希望簡化客戶端與多個MCP服務器的交互時；當您需要統一管理多個MCP連接時。

主要功能

多服務器管理支持同時連接和管理多個MCP服務器，通過配置文件統一管理

多種傳輸方式支持STDIO和SSE兩種傳輸方式，適應不同服務器類型

統一API接口提供簡潔的HTTP API，屏蔽底層服務器差異

動態更新支持運行時更新服務器配置，無需重啟服務

優勢與侷限性

優勢

簡化客戶端開發，只需與Host交互

統一管理多個MCP連接

支持動態更新服務器配置

提供標準化的API接口

侷限性

需要額外的Host服務運行

性能可能受Host服務器影響

某些高級功能可能受限

如何使用

安裝運行

可以通過npm直接運行或本地構建運行

配置服務器

在當前工作目錄創建mcp_servers.config.json文件，配置要連接的MCP服務器

使用API

通過HTTP API與Host交互，Host會自動管理底層連接

使用案例

獲取所有工具客戶端需要了解所有可用工具時

調用Puppeteer工具需要使用Puppeteer服務器提供的網頁截圖功能時

常見問題

如何添加新的MCP服務器?

Host服務器默認運行在什麼端口?

STDIO和SSE傳輸方式有什麼區別?

🚀 mcp-host-use

mcp-host-use 是一個基於 Node.js 的 Model Context Protocol (MCP) 主機應用程序，用於連接和管理多個 MCP 服務器。Host 提供了統一的接口，允許客戶端通過 HTTP API 與多個 MCP 服務器進行交互，訪問及調用工具(或資源)。

🚀 快速開始

mcp-host-use 是一個強大的基於 Node.js 的應用程序，可幫助你輕鬆連接和管理多個 MCP 服務器。下面為你介紹使用方法：

一、使用 npm 包方式：

npm install -g mcp-host-use
mcp-host-use --start

二、本地構建運行：

git clone [倉庫地址]
cd mcp-hostuse
npm install
node index.js

✨ 主要特性

支持多 MCP 服務器連接：可以同時連接和管理多個 MCP 服務器，並通過配置文件進行動態擴展。
多種數據傳輸方式：
- STDIO 通信：支持通過標準輸入輸出與外部進程交互。
- Server-Sent Events (SSE)：實現了對即時事件推送的支持。
統一的 HTTP API 接口：提供以下功能：
- 獲取所有工具列表
- 調用特定工具
- 獲取所有資源信息
- 讀取特定資源內容
- 更新服務器連接配置

📦 安裝指南

環境要求

Node.js：需要安裝 Node.js (推薦使用 v14 或更高版本)
npx：建議全局安裝 npx 工具
uvx：如果需要使用 UVX 協議，需預先安裝 Python 環境

💻 使用示例

基礎用法

配置文件

配置文件路徑：config/servers.json

示例 JSON 格式：

[
    {
        "name": "server1",
        "type": "stdio",  # 或 'sse'
        "command": "node server.js"
    },
    {
        "name": "server2",
        "type": "sse",
        "url": "http://localhost:3000"
    }
]

高級用法

注意事項

⚠️ 重要提示

服務默認運行在 17925 端口，可通過配置文件修改。

配置文件位於項目根目錄下的 config/servers.json 文件中。

如果使用 stdio 類型，請確保目標進程支持標準輸入輸出通信；如果使用 SSE 類型，需保證目標服務器正確實現了 Server-Sent Events 協議。

📚 詳細文檔

項目架構

graph TD
    A[客戶端] --> B[HTTP API]
    B --> C[MCP Host]
    C --> D[多個 MCP 服務器連接]

項目結構

mcp-host-use/
├── index.js          # 主程序入口
├── config.js        # 配置文件管理
├── connections.js   # MCP 服務器連接管理
├── tools.js         # 工具接口實現
└── resources.js     # 資源管理模塊

📄 API 文檔

一、獲取所有工具列表

GET http://localhost:17925/api/tools

響應示例：

{
  "code": 0,
  "data": [
    {
      "server_name": "服務器1",
      "tools": [
        {
          "name": "工具名稱",
          "description": "工具描述",
          "inputSchema": { ... }
        }
      ]
    }
  ]
}

二、調用特定工具

POST http://localhost:17925/api/tools/toolCall
Content-Type: application/json

{
  "server_name": "服務器名稱",
  "tool_name": "工具名稱", 
  "tool_args": { ... }
}

響應示例：

{
  "code": 0,
  "data": {
    "result": "工具執行結果"
  }
}

三、獲取所有資源信息

GET http://localhost:17925/api/resources

響應示例：

{
  "code": 0,
  "data": [
    {
      "server_name": "服務器1",
      "resources": [
        {
          "uri": "資源URI",
          "mimeType": "資源類型",
          "name": "資源名稱"
        }
      ]
    }
  ]
}

四、讀取特定資源內容

POST http://localhost:17925/api/resources/read
Content-Type: application/json

{
  "server_name": "服務器名稱",
  "resource_uri": "資源URI"
}

響應示例：

{
  "code": 0,
  "data":  [
    {
      "content": "...", 
      "mimeType": "text/plain"
    }
  ]
}

五、更新服務器連接配置

POST http://localhost:17925/api/connections/update
Content-Type: application/json

{
  "server_name": "目標服務器名稱",
  "new_config": {
    # 新的服務器配置信息
  }
}