Gopher MCP

Gopher MCP

Modern cross-platform MCP server enabling AI assistants to safely browse Gopher and Gemini resources.

4
Stars
2
Forks
2
Releases

Overview

The Gopher & Gemini MCP Server is a modern cross‑platform Model Context Protocol server that enables AI assistants to explore and interact with both Gopher and Gemini resources safely and efficiently. By bridging Gopherspace and Geminispace, it supports AI agents in discovering unique content, communities, and tools across vintage and contemporary protocols. Built with the FastMCP framework and contemporary Python practices, it delivers secure gateways, TLS encryption, and robust content filtering to guard against unsafe content. The server exposes two MCP tools, gopher_fetch and gemini_fetch, for comprehensive protocol coverage. It offers full Gopher support (menus, text, search, and binaries) and a complete Gemini implementation with gemtext parsing, TLS security, and status-code handling. Security is reinforced with TOFU certificate validation and optional Gemini client certificates, along with timeouts, size limits, and host allowlists. Responses are structured JSON tailored for AI consumption, enabling reliable parsing and reasoning by LLMs. The project prioritizes cross-platform compatibility (Windows, macOS, Linux), asynchronous I/O, and performance optimizations, and includes extensive tests, documentation, and CI/CD pipelines. Claude is cited as an example audience.

Details

Owner
cameronrye
Language
Python
License
MIT License
Updated
2025-12-07

Features

Dual Protocol Support

gopher_fetch and gemini_fetch tools provide comprehensive protocol coverage for both Gopher and Gemini.

Comprehensive Gopher Support

Handles menus (type 1), text files (type 0), search servers (type 7), and binary files (types 4,5,6,9,g,I).

Full Gemini Implementation

Native gemtext parsing, TLS security, and status code handling.

Advanced Security

TOFU certificate validation, client certificates, and secure TLS connections.

Safety First

Built-in timeouts, size limits, input sanitization, and host allowlists.

LLM-Optimized

Returns structured JSON responses designed for AI consumption.

Cross-Platform

Works on Windows, macOS, and Linux.

High Performance

Async/await patterns with intelligent caching.

Audience

AI assistantsEnable AI assistants to browse and interact with Gopher and Gemini resources safely.
DevelopersBuild and test MCP servers with best practices and robust tooling.

Tags

GopherGeminiMCPAISecurityTLSAsyncFastMCPCross-PlatformPythonGopherspaceGeminispace