Skip to content

Installation Guide

This guide covers different ways to install and set up Gopher MCP.

Requirements

  • Python 3.11 or later
  • Operating System: Linux, macOS, or Windows

Installation Methods

pip install gopher-mcp

Method 2: From Source

# Clone the repository
git clone https://github.com/cameronrye/gopher-mcp.git
cd gopher-mcp

# Install with uv (recommended)
uv sync

# Or install with pip
pip install -e .

Method 3: Development Installation

For contributors and developers:

# Clone and set up development environment
git clone https://github.com/cameronrye/gopher-mcp.git
cd gopher-mcp

# Run the development setup script
./scripts/dev-setup.sh

Verification

Verify your installation:

# Check version
gopher-mcp --version

# Run basic health check
gopher-mcp --help

Configuration

MCP Client Integration

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "gopher": {
      "command": "gopher-mcp",
      "args": []
    }
  }
}

Other MCP Clients

For HTTP transport:

{
  "mcpServers": {
    "gopher": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Troubleshooting

Common Issues

Import Error: Ensure Python 3.11+ is installed

python --version

Permission Error: Use virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install gopher-mcp

Network Issues: Check firewall settings for Gopher port 70

Getting Help