MCP Server Setup & Editor Integrations

Learn how to connect Gherkio's Model Context Protocol (MCP) server to your favorite AI assistant clients, IDEs, and environments.

🚀 Connecting to Clients

You can connect Gherkio's Model Context Protocol (MCP) server to your client using two execution paths:

Binary Mode (Standard): Invokes the locally installed gherkio mcp executable.
Zero-Install Mode (Go Run): Dynamically fetches and runs the server using standard Go remote module execution:
```
go run github.com/muhfaris/gherkio@v0.1.0-alpha.5 mcp
```

🛠️ Configuration Blocks

1. Claude Desktop Setup

To enable Claude Desktop to invoke Gherkio's testing suite, add the server command to your local Claude configuration file:

Mac Path: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows Path: %APPDATA%\Claude\claude_desktop_config.json

Option A: Local Binary (Recommended for speed)

{
  "mcpServers": {
    "gherkio": {
      "command": "gherkio",
      "args": ["mcp"],
      "env": {
        "PATH": "/usr/local/bin:/opt/homebrew/bin:/usr/bin"
      }
    }
  }
}

Option B: Zero-Install (Go Run)

{
  "mcpServers": {
    "gherkio": {
      "command": "go",
      "args": ["run", "github.com/muhfaris/gherkio@v0.1.0-alpha.5", "mcp"],
      "env": {
        "PATH": "/usr/local/bin:/opt/homebrew/bin:/usr/bin"
      }
    }
  }
}

2. Cursor IDE Integration

To use Gherkio dynamically within Cursor's Composer or Chat:

Open Cursor Settings ➔ Features ➔ MCP.
Click + Add New MCP Server.
Configure the following fields:

Option A: Local Binary (Recommended for speed)

Name: gherkio
Type: stdio
Command: /absolute/path/to/gherkio mcp (e.g. /home/username/go/bin/gherkio mcp)

Option B: Zero-Install (Go Run)

Name: gherkio
Type: stdio
Command: go run github.com/muhfaris/gherkio@v0.1.0-alpha.5 mcp

Click Save. The status dot should immediately turn green.

3. VS Code Integration (Roo Code / Continue)

If you use Roo Code (Roo Cline) or Continue extensions in VS Code, add Gherkio to your custom MCP servers list:

Option A: Local Binary (Recommended for speed)

{
  "mcpServers": {
    "gherkio": {
      "command": "gherkio",
      "args": ["mcp"]
    }
  }
}

Option B: Zero-Install (Go Run)

{
  "mcpServers": {
    "gherkio": {
      "command": "go",
      "args": ["run", "github.com/muhfaris/gherkio@v0.1.0-alpha.5", "mcp"]
    }
  }
}

4. Zed Editor Configuration

To activate Gherkio's MCP capabilities within the Zed editor's built-in assistant, edit your local ~/.config/zed/settings.json file:

Option A: Local Binary (Recommended for speed)

{
  "context_servers": {
    "gherkio": {
      "command": "gherkio",
      "args": ["mcp"]
    }
  }
}

Option B: Zero-Install (Go Run)

{
  "context_servers": {
    "gherkio": {
      "command": "go",
      "args": ["run", "github.com/muhfaris/gherkio@v0.1.0-alpha.5", "mcp"]
    }
  }
}

✅ Troubleshooting

Red / Offline Connection State

If your client fails to connect or Gherkio's status dot is red:

Check PATH: Ensure the directory where gherkio is installed (e.g. /home/username/go/bin or /usr/local/bin) is present in the PATH environment variable defined in the configuration block.
Execute manually: Run gherkio mcp in your system shell. It should start silently and wait for stdin. Press Ctrl+C to terminate it. If it fails with command not found, re-run the go install procedure.

Gherkio Documentation