开源MCP工具

Prerequisites

• Python 3.11+ - Download here
• uv package manager - Install uv

Installation

Option 1: Development Installation (Recommended)

```bash

Install from PyPI (recommended for end users)

pip install gopher-mcp

Install directly from GitHub

uv add git+https://github.com/cameronrye/gopher-mcp.git

Or install in development mode

git clone https://github.com/cameronrye/gopher-mcp.git cd gopher-mcp uv sync --all-extras ```

Quick Start

Usage

The server provides two powerful MCP tools for exploring alternative internet protocols:

Example URLs to Try

Gopher Protocol

```bash

Search example (type 7)

gopher://gopher.floodgap.com/7/v2/vs

Text file example

gopher://gopher.floodgap.com/0/gopher/welcome

#### Gemini Protocol

Example personal gemlog

gemini://warmedal.se/~antenna/

Example AI Interactions

Once configured, you can ask Claude:

Gopher Exploration:

• "Browse the main Gopher menu at gopher.floodgap.com"
• "Search for 'python' on the Veronica-2 search server"
• "Show me the welcome text from Floodgap's Gopher server"
• "What's available in the Gopher community directory?"

Gemini Exploration:

• "Fetch the Gemini protocol homepage"
• "Show me the software directory on geminiprotocol.net"
• "Browse the latest posts from a gemlog"
• "What's the difference between Gopher and Gemini protocols?"

Example Configuration

```bash

Set up development environment

./scripts/dev-setup.sh # Unix/macOS

Configuration

The server can be configured through environment variables for both protocols:

Gopher Configuration

Gemini Configuration

Gopher settings

export GOPHER_MAX_RESPONSE_SIZE=2097152 export GOPHER_TIMEOUT_SECONDS=60 export GOPHER_CACHE_ENABLED=true export GOPHER_ALLOWED_HOSTS="gopher.floodgap.com,gopher.quux.org"

Gemini settings

export GEMINI_MAX_RESPONSE_SIZE=2097152 export GEMINI_TIMEOUT_SECONDS=60 export GEMINI_TOFU_ENABLED=true export GEMINI_CLIENT_CERTS_ENABLED=true export GEMINI_ALLOWED_HOSTS="geminiprotocol.net,warmedal.se"

Run with custom config

uv run task serve ```

Claude Desktop Integration

Add to your claude_desktop_config.json:

Unix/macOS/Linux:

{
  "mcpServers": {
    "gopher": {
      "command": "uv",
      "args": ["--directory", "/path/to/gopher-mcp", "run", "task", "serve"],
      "env": {
        "MAX_RESPONSE_SIZE": "1048576",
        "TIMEOUT_SECONDS": "30"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "gopher": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\gopher-mcp",
        "run",
        "task",
        "serve"
      ],
      "env": {
        "MAX_RESPONSE_SIZE": "1048576",
        "TIMEOUT_SECONDS": "30"
      }
    }
  }
}

Development Workflow

1. Setup: uv run task dev-setup - Install dependencies and pre-commit hooks
2. Code: Make your changes with full IDE support (type hints, linting)
3. Quality: uv run task quality - Run all quality checks (lint + typecheck + test)
4. Test: uv run task test-cov - Run tests with coverage reporting
5. Commit: Pre-commit hooks ensure code quality automatically

Alternative Options

```bash