mirror of https://github.com/hanzoai/mcp.git synced 2026-10-15 12:30:12 +00:00

Files

T

zeekay 6fc4f60d36 Further improve documentation organization

- Create guides directory for integration documentation
  - Add LIBRECHAT_INTEGRATION.md and MCP_SSE_CONNECTION_GUIDE.md
  - Include README with guide descriptions

- Create media directory for documentation assets
  - Move example.gif to dedicated media directory
  - Add README with media usage guidelines

- Update main documentation README.md
  - Add comprehensive directory structure overview
  - Improve organization with clear categories
  - Add links to all documentation resources

2025-05-10 03:40:50 -05:00

3.2 KiB

Raw Permalink Blame History

Hanzo MCP Integration with LibreChat

This guide explains how to integrate the Hanzo MCP server with LibreChat, including configuring the port settings for SSE transport.

Updates Overview

The Hanzo MCP server has been updated to support the following features:

Configurable port for SSE transport via the --port parameter
Configurable host via the --host parameter
Better handling of port conflicts
Improved integration with LibreChat

Installation

First, make sure the updated Hanzo MCP package is installed:

cd /Users/z/work/hanzo/mcp
./update_cli.sh

Then, update the LibreChat configuration:

cd /Users/z/work/hanzo/chat
./update_mcp.sh

Manual Configuration

If you want to manually configure the integration, follow these steps:

1. LibreChat YAML Configuration

Update your librechat.yaml file to use the SSE transport:

mcpServers:
  hanzo-mcp:
    type: sse
    url: http://localhost:3001/sse
    timeout: 60000
    initTimeout: 15000

Or if you prefer stdio transport:

mcpServers:
  hanzo-mcp:
    type: stdio
    command: python3
    args:
      - -m
      - hanzo_mcp.cli
      - --port
      - "3001"
    timeout: 60000
    initTimeout: 15000

2. Starting the MCP Server

For SSE transport:

python3 -m hanzo_mcp.cli --transport sse --port 3001

For stdio transport, LibreChat will start the server automatically.

Troubleshooting

Port Conflicts

If you see errors about port 3001 being in use, you can:

Kill the process using the port:

lsof -i :3001  # Find the process
kill <PID>     # Kill it

Or use a different port:

# In your command:
python3 -m hanzo_mcp.cli --transport sse --port 3002

# And update librechat.yaml to use port 3002

Connection Issues

If LibreChat can't connect to the MCP server:

Ensure the server is running:
```
ps aux | grep hanzo_mcp
```
Check the URL in the LibreChat configuration matches the port the server is running on
Try using localhost instead of 127.0.0.1 or vice versa
If using Docker, you might need to use host.docker.internal instead of localhost

Advanced Usage

Environment Variables

The MCP server also respects these environment variables:

FASTMCP_PORT: Port to use for SSE transport
FASTMCP_HOST: Host to bind to for SSE transport

Example:

FASTMCP_PORT=3002 FASTMCP_HOST=0.0.0.0 python3 -m hanzo_mcp.cli --transport sse

Command Line Options

The CLI now supports these options:

--transport {stdio,sse}  Transport protocol to use (default: stdio)
--port PORT              Port to use for SSE transport (default: 3001)
--host HOST              Host to bind to for SSE transport (default: 0.0.0.0)
--name NAME             Name of the MCP server (default: claude-code)
--allow-path ALLOWED_PATHS  Add an allowed path (can be specified multiple times)

Key Files

/Users/z/work/hanzo/mcp/hanzo_mcp/cli.py: Main CLI entry point
/Users/z/work/hanzo/mcp/hanzo_mcp/server.py: Server implementation
/Users/z/work/hanzo/chat/librechat.yaml: LibreChat configuration
/Users/z/work/hanzo/chat/run_mcp_server.py: Helper script to run MCP server

3.2 KiB Raw Permalink Blame History