mcp-host-use

mcp-host-use

site icon
2025.04.16 3
TypeScriptMCP 主机管理HTTP API 接口开发效率
mcp-host-use 是一个基于 Node.js 的 Model Context Protocol (MCP) 主机应用程序,用于连接和管理多个 MCP 服务器。它提供了统一的 HTTP API 接口,允许客户端与多个 MCP 服务器进行交互,访问及调用工具或资源。支持 STDIO 和 SSE 两种传输方式,适用于快速测试及运行 MCP Servers 的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-host-use 是一个 MCP 主机应用程序,用于连接和管理多个 MCP 服务器,提供统一的 HTTP API 接口。

核心功能

  • 支持同时连接多个 MCP 服务器,通过 JSON 文件管理服务器配置。
  • 支持 STDIO 和 SSE 两种传输方式。
  • 提供统一的 HTTP API 接口,包括:
  • 获取所有服务器的工具列表
  • 调用特定服务器上的工具
  • 获取所有服务器的资源列表
  • 获取特定服务器上的资源
  • 触发 Host 主动更新 Server 连接

适用场景

  • 快速测试及运行 MCP Servers
  • 管理多个 MCP 服务器的连接和交互
  • 通过统一的 HTTP API 访问和调用 MCP 服务器的工具和资源

工具列表

  • npx mcp-host-use:无需本地构建,直接运行 MCP Host 服务器。
  • npm install:安装依赖。
  • npm run dev:开发模式运行。
  • npm run build:生产环境构建。

常见问题解答

  • 确保配置文件中的服务器信息正确。
  • 对于 STDIO 传输方式,确保 npxuvx 可执行。
  • 对于 SSE 传输方式,确保 URL 可访问。

使用教程

使用依赖

  • 连接 STDIO MCP Server 需要 npxuvx 的系统运行环境。
  • npx 依赖 Node.js (>=18)
  • uvx 依赖 Python (uv)

安装教程

  1. 使用 npm 包(推荐): bash npx mcp-host-use
  2. 本地构建: bash git clone https://github.com/liujilongObject/mcp-host-use.git cd mcp-host-use npm install

调试方式

  1. 开发模式运行: bash npm run dev
  2. 生产模式构建: bash npm run build
  3. 使用自定义的 Node.js 环境: bash production_node.exe dist/index.js
  4. 使用宿主机的 Node.js 环境: bash node dist/index.js

许可证

该项目遵循 None 开源许可条款。