Home

Gopher & Gemini MCP Server Wiki

Welcome to the Gopher & Gemini MCP Server wiki! This wiki provides comprehensive documentation, guides, and resources for using and contributing to the project.

What is Gopher & Gemini MCP Server?

A modern, cross-platform Model Context Protocol (MCP) server that enables AI assistants to browse and interact with both Gopher protocol and Gemini protocol resources safely and efficiently.

Quick Links

• Installation Guide
• Configuration
• API Reference
• Advanced Features
• Contributing Guide
• Troubleshooting

Getting Started

Prerequisites

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

Quick Installation

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

# Set up development environment
./scripts/dev-setup.sh  # Unix/macOS
# or
scripts\dev-setup.bat   # Windows

# Run the server
uv run task serve

Documentation

User Guides

• Installation - Complete installation instructions for all platforms
• Configuration - Environment variables and settings
• Usage Examples - Common use cases and examples
• AI Assistant Guide - How to use with Claude and other LLMs

Developer Guides

• Architecture - System design and component overview
• API Reference - Complete API documentation
• Contributing - How to contribute to the project
• Development Setup - Setting up your development environment
• Testing Guide - Writing and running tests

Protocol Guides

• Gopher Protocol - Understanding the Gopher protocol
• Gemini Protocol - Understanding the Gemini protocol
• Security Features - TOFU, TLS, and security best practices

Advanced Topics

• Advanced Features - Caching, client certificates, and more
• Performance Tuning - Optimization tips and best practices
• Troubleshooting - Common issues and solutions
• Migration Guide - Upgrading between versions

Features

• Dual Protocol Support: gopher_fetch and gemini_fetch tools
• Comprehensive Gopher Support: Menus, text files, search servers, and binary files
• Full Gemini Implementation: Native gemtext parsing, TLS security, status codes
• Advanced Security: TOFU certificate validation, client certificates, secure TLS
• Safety First: Built-in timeouts, size limits, input sanitization, host allowlists
• LLM-Optimized: Structured JSON responses designed for AI consumption
• Cross-Platform: Works on Windows, macOS, and Linux
• Modern Development: Full type checking, linting, testing, and CI/CD

Community

• GitHub Repository: cameronrye/gopher-mcp
• Documentation: cameronrye.github.io/gopher-mcp
• Bug Reports: GitHub Issues
• Feature Requests: GitHub Discussions
• MCP Community: MCP Discord

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by Cameron Rye