MCP Host CLI

一个基于Node.js的MCP主机应用，用于连接和管理多个MCP服务器

开发者工具人工智能聊天机器人 #MCP主机 #服务器管理 #HTTP API #工具调用 .TypeScript

评分 : 2.5分

下载量 : 25

更新时间 : 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": {
    # 新的服务器配置信息
  }
}