This commit implements a flexible tool filtering system for Claude Desktop compatibility.
Features:
- Whitelist mode: Only enable specified tools
- Blacklist mode: Disable specified tools (default enables all)
- Passthrough mode: No filtering (default if no lists provided)
- Validation: Prevents conflicting enabled/disabled lists
Implementation:
- ToolFilter class with three filtering modes
- should_include_tool() for individual tool checks
- filter_tools_list() for filtering tool definition lists
- filter_tools_response() for filtering MCP list_tools responses
- get_filter_stats() for observability and debugging
This module integrates with the configuration loader (#11) and will be used by the HTTP MCP server (#14) to ensure only compatible tools are exposed to Claude Desktop.
Closes#12
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit implements a robust configuration loader using Pydantic Settings that handles:
Features:
- Environment variable loading with .env file support
- Type validation and field constraints
- Gitea configuration (URL, token, owner, repo)
- HTTP server configuration (host, port)
- Optional HTTP authentication token
- Optional tool filtering (enabled/disabled tool lists)
Implementation:
- GiteaSettings class with Pydantic validation
- URL validation ensuring http:// or https:// prefix
- Helper properties for parsing comma-separated tool lists
- get_gitea_mcp_env() method to pass config to wrapped MCP server
- load_settings() factory function with optional env_file path
Documentation:
- .env.example template with all configuration options
- Comprehensive docstrings and type hints
This module unblocks both the tool filtering (#12) and HTTP authentication middleware (#13) implementations.
Closes#11
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit establishes the proper architecture for an HTTP transport wrapper around the official Gitea MCP server, replacing the incorrect standalone implementation.
New structure:
- src/gitea_http_wrapper/ (main package)
- config/ (configuration loader)
- middleware/ (HTTP auth middleware)
- filtering/ (tool filtering for Claude Desktop)
- tests/ (wrapper test suite)
Updated dependencies:
- mcp>=0.9.0 (MCP SDK for HTTP transport)
- uvicorn>=0.27.0 (ASGI server)
- pydantic>=2.0.0 (config validation)
- pydantic-settings>=2.0.0 (settings management)
- gitea-mcp-server>=0.1.0 (official Gitea MCP to wrap)
Created requirements.txt for Docker deployment convenience.
This architecture correctly separates concerns:
1. Official Gitea MCP server handles Gitea API operations
2. HTTP wrapper provides transport, auth, and filtering
Closes#10
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
