MCP Server Hub Server

🚀 MCP Server Guide

This guide provides a comprehensive overview of setting up, configuring, and using the MCP server. It also includes troubleshooting tips, development, and testing instructions.

🚀 Quick Start

📦 Installation

Download the Code

Clone the repository from GitHub:

git clone https://github.com/your-repository/mcp-server.git
cd mcp-server

Install Dependencies

Install project dependencies using npm:

npm install

Start the Server

Run the main program file:

node src/index.js

⚙️ Configuration

Configure the MCP Server

Edit the configuration file mcp_hub_config.json to ensure the paths are correct. For example:

{
  "wsPort": 8081,
  "configPath": "path/to/mcp_server_settings.json"
}

Use the LLM Client (e.g., Cline)

Configure the MCP server in the LLM client: Edit the client's MCP configuration file, such as cline_mcp_settings.json:

{
  "mcpServers": {
    "gateway-client": {
      "command": "node",
      "args": ["path/to/mcp-server/gateway-client.js"],
      "options": {
        "cwd": "path/to/mcp-server"
      }
    }
  }
}

💻 Usage Examples

Tool Listing

Execute the following command in the LLM client:

llm list-tools

Example output:

{
  "tools": ["hub__example", "thought-server__integrated-thinking"]
}

Tool Invocation

Invoke a tool using its fully qualified name (e.g., hub__example):

llm call-tool --tool hub__example --args '{"input": "test"}'

🛠️ Troubleshooting

Problem Diagnosis

1. Startup Failure: Check the configuration file paths and commands for accuracy.
2. Connection Issues: Ensure the server is running and the network firewall is not blocking the WebSocket port (default ws://localhost:8081).

Log Inspection

View the MCP server logs:

# Run the following command in the terminal to view real-time output
npm run dev

🛠️ Development and Testing

Development Mode

Use nodemon to monitor file changes:

npm run dev

Testing

Run unit tests:

npm test

For more detailed information, please refer to the project documentation.