gitea-mcp-remote/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.0] - 2026-02-03

Added

• MCP Streamable HTTP protocol support (/mcp endpoint with POST/HEAD)
• Two-service Docker infrastructure with Caddy reverse proxy (docker/)
• Production startup script (scripts/start.sh) with environment validation
• Health check script (scripts/healthcheck.sh) for Docker
• CLAUDE.md with comprehensive project guidance for AI assistants
• Health endpoint tests with authentication bypass verification

Changed

• BREAKING: Package renamed from gitea_http_wrapper to gitea_mcp_remote
• BREAKING: Default HTTP port changed from 8000 to 8080
• BREAKING: Default HTTP host changed from 127.0.0.1 to 0.0.0.0
• Architecture changed from subprocess wrapper to direct marketplace import
• Server implementation uses StreamableHTTPServerTransport from MCP SDK
• Tests moved from src/gitea_mcp_remote/tests/ to repository root tests/
• Middleware order fixed: HealthCheckBypass now wraps BearerAuth (runs first)
• Docker files moved to docker/ directory with Caddy service added
• Updated README.md and DEPLOYMENT.md with correct architecture documentation

Fixed

• Health endpoint returning 401 when AUTH_TOKEN was set (middleware order bug)
• pyproject.toml testpaths pointing to wrong directory

[1.0.0] - 2025-02-03

Changed

• BREAKING: Complete architectural rebuild from standalone MCP server to HTTP wrapper pattern
• BREAKING: Now wraps official gitea-mcp-server package instead of implementing Gitea operations directly
• Project renamed from standalone implementation to HTTP transport wrapper

Added

• HTTP transport layer via Starlette/uvicorn for Claude Desktop compatibility
• Configuration management module (config/) with environment variable support
• Tool filtering module (filtering/) for Claude Desktop compatibility controls
• Bearer token authentication middleware (middleware/auth.py)
• Comprehensive test suite (30 tests covering all modules)
• Docker deployment infrastructure with docker-compose.yml
• Health check endpoints (/health, /healthz, /ping)
• Deployment documentation and Docker guides
• Environment variable configuration with .env support

Removed

• Standalone MCP tool implementations (now delegated to wrapped gitea-mcp-server)
• Direct Gitea API integration code (handled by wrapped server)

[0.1.0] - 2025-01-XX (Initial Standalone Implementation)

Added

• Initial Python project structure
• MCP server core with stdio transport
• Issue operations (create, update, list, get)
• Label operations (add, remove, list)
• Milestone operations (create, update, list)
• Authentication with Gitea API tokens
• Comprehensive README and documentation

Notes

• This version was a standalone MCP server implementation
• Superseded by HTTP wrapper architecture in Sprint 02