MCPHub Documentation

Everything you need to know about using MCPHub with your Claude assistant.

Installation

1. Install MCPHub Gateway

Install the MCPHub gateway globally using npm:

npm install -g @mcphub/gateway

2. Configure Claude Desktop

Add MCPHub to your Claude Desktop configuration file:

Configuration file location:

  • macOS: ~/Library/Application Support/Claude Desktop/config.json
  • Windows: %APPDATA%\Claude Desktop\config.json

Add this configuration:

{
  "mcpServers": {
    "mcphub": {
      "command": "node",
      "args": ["<path-to-gateway>/mcphub-gateway.js"]
    }
  }
}

Replace "<path-to-gateway>" with your actual gateway path. Find it using:

npm list -g @mcphub/gateway

Usage Examples

Using MCPHub in Claude Desktop

After installation, you can use MCPHub services in your conversations. Here are some examples:

Example 1: List MCP Servers

Ask Claude:

"Can you search for all Python MCP servers?"

Example 2: Find a MCP Server Detail

Ask Claude:

"I would like to find a mcp server for duckdb database."

Troubleshooting

Nothing showing up in Claude Desktop?

  1. 1. Check if MCP is enabled:

    • Click the 🔌 icon in Claude Desktop, next to the chat box
    • Expand "Installed MCP Servers"
    • You should see your configured servers
  2. 2. Verify your config:

    • From Claude Desktop, go to Claude > Settings…
    • Open the "Developer" tab to see your configuration
  3. 3. Restart Claude Desktop completely:

    • Quit the app (not just close the window)
    • Start it again

MCP or database errors?

Check Claude Desktop's logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Look specifically for the MCPHub log file:

tail -f ~/Library/Logs/Claude/mcp-server-mcphub.log