mcpilot-pair

MCPilot Pair

MCPilot Pair securely links your local dev environment to LLMs via reverse tunnels (SSH/Ngrok). Edit files, run Git commands, or execute make test - all while keeping control. Built on the Model Context Protocol (MCP), it’s your AI-ready co-pilot for private, efficient workflows.

In case you want to know more about MCP, check out https://modelcontextprotocol.io/docs/getting-started/intro

[!WARNING] This software may write to the local file system and execute scripts locally. Use with caution and at your own risk. No responsibility or liability is accepted for any damages or data loss resulting from its use.

Installation

Install the tool using go install:

go install github.com/seb-schulz/mcpilot-pair@latest

Usage

As a Server

Start the server with a custom port (default: 8080):

mcpilot-pair --port 9090  # or -p 9090

The API key is automatically generated and saved in: ~/.config/mcpilot-pair/api-key.txt (XDG-compliant).

Establishing a Connection

You can connect to the MCP server in various ways:

Via SSH Tunnel

ssh -R 127.0.0.1:30204:127.0.0.1:8080 example.com

Using Apache Rewrite Rule

If you use Apache, you can use a Rewrite Rule:

RewriteCond %{HTTP_HOST} ^rand-sub\.example\.com$ [NC]
RewriteRule ^(.*) http://127.0.0.1:30204/$1 [proxy,last]

With Custom Connectors

The MCP server can be connected to various LLMs, including:

• Le Chat (Mistral AI) – supports custom MCP servers directly.
• Claude (Anthropic) – supports local and remote MCP servers.
• Gemini (Google) – supports MCP servers via Gemini CLI (don't know if this is useful).
• ChatGPT: – not supported yet. ChatGPT supports MCP servers only in a limited capacity. Check their documentation about details.

Set up a custom connector in Le Chat (3 steps):

1. Open Connectors: In Le Chat, click the toggle panel → Intelligence → Connectors → + Add Connector → Custom MCP Connector.

2. Configure API: Enter your API endpoint, auth method (API key).

3. Test & save - now use it in chat with: “Ask [Connector Name] for [your query].”

Working with Dev Containers

To use MCPilot Pair in a Dev Container, mount the config directory to persist the API key:

Example .devcontainer.json

{
  // [...]
  "mounts": [
    "source=${localEnv:HOME}/.config/mcpilot-pair,target=/home/vscode/.config/mcpilot-pair,type=bind,consistency=cached"
  ]
}

This ensures the API key is shared between host and container.

Contributing

Pull requests are welcome! Make sure to:

1. Run go test ./... before committing.
2. Follow the Google Go Style Guide.

License

This project is licensed under the MIT License. See LICENSE for details.