MCP Kit Local Relay
by trevoruptain
This command-line tool bridges local MCP clients with remote MCP Servers configured using the MCP Kit Web App. It proxies requests to a single target server, making its tools available locally.
Last updated: N/A
What is MCP Kit Local Relay?
The MCP Kit Local Relay is a command-line tool that allows local applications, such as Claude Desktop, to interact with remote MCP Servers. It acts as a proxy, forwarding requests from the local client to a specified remote server.
How to use MCP Kit Local Relay?
To use the relay, clone the repository, install dependencies, configure the .env and mcpconfig.json files with your API key and target server ID, build the relay, and configure your local MCP client (e.g., Claude Desktop) to use the relay's executable.
Key features of MCP Kit Local Relay
Bridges local MCP clients with remote MCP Servers
Proxies requests to a single target server
Supports standard input/output (stdio) communication
Configuration via
.envandmcpconfig.jsonfiles
Use cases of MCP Kit Local Relay
Connecting Claude Desktop to remote MCP Servers
Testing MCP server tools locally
Integrating MCP server tools with other stdio-based applications
Developing and debugging MCP server integrations
FAQ from MCP Kit Local Relay
Hammer icon missing or tools not listed in Claude Desktop?
Hammer icon missing or tools not listed in Claude Desktop?
Double-check the absolute path to dist/index.js in claude_desktop_config.json. Verify npm run build completed without errors. Ensure .env and mcpconfig.json exist in the local-relay directory and contain the correct API key and Server ID.
What if I encounter relay errors?
What if I encounter relay errors?
Check the local-relay-debug.log file for detailed error messages. Ensure your MCP_SERVER_URL points to a running instance of the mcp-kit-server. Confirm your MCPKIT_API_KEY is valid.
How do I run the relay in development mode?
How do I run the relay in development mode?
Use the command npm run dev to run the relay with automatic restarts on code changes.
What is the purpose of the --stack-size flag?
What is the purpose of the --stack-size flag?
The --stack-size flag is included to prevent potential 'Maximum call stack size exceeded' errors when dealing with large resources (like images).
Where can I find more detailed instructions on editing the Claude config?
Where can I find more detailed instructions on editing the Claude config?
See the Local Relay Documentation (https://docs.mcpkit.ai/essentials/local-relay).