MCP Host CLI

🚀 mcp-host-use

mcp-host-use is a Node.js-based Model Context Protocol (MCP) host application designed to connect and manage multiple MCP servers. It offers a unified interface, enabling clients to interact with multiple MCP servers via HTTP API, access, and invoke tools (or resources).

🚀 Quick Start

Prerequisites

• Node.js: Install Node.js (version v14 or higher is recommended).
• npx: It is advisable to globally install the npx tool.
• uvx: If you need to use the UVX protocol, you must pre-install a Python environment.

Installation

Method 1: Using npm Package

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

Method 2: Local Build and Run

git clone [Repository URL]
cd mcp-hostuse
npm install
node index.js

✨ Features

1. Support for Multiple MCP Server Connections:

   • It can simultaneously connect to and manage multiple MCP servers, and be dynamically expanded through configuration files.

2. Multiple Data Transmission Modes:

   • STDIO Communication: Supports interaction with external processes through standard input and output.
   • Server-Sent Events (SSE): Implements support for real-time event pushing.

3. Unified HTTP API Interface:

   • Get a list of all tools.
   • Invoke specific tools.
   • Obtain information about all resources.
   • Read the content of specific resources.
   • Update server connection configurations.

📦 Project Structure

mcp-host-use/
├── index.js          # Main program entry
├── config.js        # Configuration file management
├── connections.js   # MCP server connection management
├── tools.js         # Tool interface implementation
└── resources.js     # Resource management module

📚 Documentation

Configuration File

Configuration File Path: config/servers.json

Example JSON Format:

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

Notes

⚠️ Important Note

• The service runs on port 17925 by default, which can be modified via the configuration file.
• The configuration file is located at config/servers.json in the project root directory.
• If using the stdio type, ensure that the target process supports standard input and output communication. If using the SSE type, ensure that the target server correctly implements the Server-Sent Events protocol.

💻 Usage Examples

Basic Usage

The following shows how to start the application using the npm package:

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

Advanced Usage

The following shows how to build and run the application locally:

git clone [Repository URL]
cd mcp-hostuse
npm install
node index.js

📄 API Documentation

1. Get a List of All Tools

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

Response Example:

{
  "code": 0,
  "data": [
    {
      "server_name": "Server 1",
      "tools": [
        {
          "name": "Tool Name",
          "description": "Tool Description",
          "inputSchema": { ... }
        }
      ]
    }
  ]
}

2. Invoke a Specific Tool

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

{
  "server_name": "Server Name",
  "tool_name": "Tool Name", 
  "tool_args": { ... }
}

Response Example:

{
  "code": 0,
  "data": {
    "result": "Tool Execution Result"
  }
}

3. Get Information about All Resources

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

Response Example:

{
  "code": 0,
  "data": [
    {
      "server_name": "Server 1",
      "resources": [
        {
          "uri": "Resource URI",
          "mimeType": "Resource Type",
          "name": "Resource Name"
        }
      ]
    }
  ]
}

4. Read the Content of a Specific Resource

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

{
  "server_name": "Server Name",
  "resource_uri": "Resource URI"
}

Response Example:

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

5. Update Server Connection Configuration

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

{
  "server_name": "Target Server Name",
  "new_config": {
    # New server configuration information
  }
}

📦 Project Architecture

graph TD
    A[Client] --> B[HTTP API]
    B --> C[MCP Host]
    C --> D[Multiple MCP Server Connections]

📄 License

[TODO: Add license information]

👥 Contributors

[TODO: Add a list of contributors]