Skip to content

cameronrye/gopher-mcp

v0.4.1 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

gemini gemini-protocol gopher gopher-protocol mcp mcp-server

ReleasePort's take

Light signal
editorial:auto 1mo

v0.4.1 consolidates documentation into a single source of truth and updates references to remove fabricated variables.

Why it matters: Fixes stale claims in docs, ensuring examples align with actual response‑model fields; improves reliability for developers referencing the API.

Summary

AI summary

Version 0.4.1, commit a7156f6 and workflow 27172252771 bring documentation consolidation, data‑model reference updates, and duplicate docs removal.

Changes in this release

Feature Low

Added auto‑generated Data Models reference page rendered directly from Pydantic models, replacing hand‑written API reference interfaces.

Added auto‑generated Data Models reference page rendered directly from Pydantic models, replacing hand‑written API reference interfaces.

Source: llm_adapter@2026-06-09

Confidence: high

Deprecation Low

Removed duplicate `wiki-content/` documentation tree, migrating its content into `docs/`.

Removed duplicate `wiki-content/` documentation tree, migrating its content into `docs/`.

Source: llm_adapter@2026-06-09

Confidence: high

Bugfix Medium

Corrected documentation to remove fabricated environment variables and stale claims, aligning examples with actual response-model fields.

Corrected documentation to remove fabricated environment variables and stale claims, aligning examples with actual response-model fields.

Source: llm_adapter@2026-06-09

Confidence: high

Refactor Low

Consolidated documentation into a single source of truth, updating environment variable prefixes and paths.

Consolidated documentation into a single source of truth, updating environment variable prefixes and paths.

Source: llm_adapter@2026-06-09

Confidence: high

Refactor Low

Enabled markdownlint on the `docs/` tree via pre‑commit/CI checks.

Enabled markdownlint on the `docs/` tree via pre‑commit/CI checks.

Source: llm_adapter@2026-06-09

Confidence: high

Full changelog

Added

  • Serialization-contract tests that pin the public result models' model_dump()
    key sets, guarding the documented response shape against silent drift.

Changed

  • Made the published documentation site the single source of truth: consolidated
    six overlapping release/PyPI/testing docs into one development/releasing
    guide, surfaced the previously-orphaned Configuration and Architecture pages in
    the nav, added a general Troubleshooting page, and corrected the docs against
    the v0.4.0 source — all four MCP tools (plus the gemini_fetch input
    parameter and the batch-fetch tools) and PyPI install are now documented,
    server/logging environment variables carry the GOPHER_MCP_ prefix, TOFU and
    certificate paths point to ~/.gemini, and the Gemini specification is
    standardized to v0.24.1.
  • Added an auto-generated Data Models reference page (via mkdocstrings) rendered
    directly from the Pydantic models, replacing the hand-written response-type
    interfaces in the API reference so they can no longer drift from the code.
  • Enabled markdownlint on the docs/ tree in pre-commit/CI.

Removed

  • Deleted the duplicate wiki-content/ documentation tree (its unique
    general/Claude Desktop troubleshooting and per-OS config paths were migrated
    into docs/) and dropped the internal Gemini planning drafts (project
    timeline, API contracts, security architecture) from the public site.

Fixed

  • Removed fabricated GEMINI_TLS_*, DEBUG_COMPONENTS, and MCP_SERVER_*
    environment variables and stale single-tool / source-only / Pituophis /
    tools.py / GopherMCPServer claims from the documentation, and corrected the
    documented response-model fields to match the code.
  • Corrected the documentation code examples to access the real serialized
    response keys (title, text/bytes, note, new_url, and the nested

Release Information:

  • Version: 0.4.1
  • Release Date: 2026-06-08
  • Commit: a7156f6
  • Workflow: 27172252771

Installation:

pip install gopher-mcp==0.4.1

Verification:
All packages are signed and can be verified using Sigstore.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track cameronrye/gopher-mcp

Get notified when new releases ship.

Sign up free

About cameronrye/gopher-mcp

Modern, cross-platform MCP server enabling AI assistants to browse and interact with both Gopher protocol and Gemini protocol resources safely and efficiently. Features dual protocol support, TLS security, and structured content extraction.

All releases →

Related context

Earlier breaking changes

  • v0.5.0 Changes Gemini binary success responses to return only metadata, dropping base64‑inlined bodies.
  • v0.3.0 Reject `--mount-path` for transports that ignore it instead of silently dropping.
  • v0.3.0 Server settings now read under `GOPHER_MCP_` environment prefix; update any existing env vars accordingly.

Beta — feedback welcome: [email protected]