MCP Host CLI

🚀 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

✨ 主要特性

1. 支持多 MCP 服務器連接：可以同時連接和管理多個 MCP 服務器，並通過配置文件進行動態擴展。
2. 多種數據傳輸方式：
   • STDIO 通信：支持通過標準輸入輸出與外部進程交互。
   • Server-Sent Events (SSE)：實現了對即時事件推送的支持。
3. 統一的 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"
    }
]

高級用法

注意事項

⚠️ 重要提示

1. 服務默認運行在 17925 端口，可通過配置文件修改。
2. 配置文件位於項目根目錄下的 config/servers.json 文件中。
3. 如果使用 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": {
    # 新的服務器配置信息
  }
}

📄 許可證

[TODO: 添加許可證信息]

貢獻者

[TODO: 添加貢獻者列表]