ccproxy-api 0.1.2__tar.gz → 0.1.3__tar.gz

ccproxy_api-0.1.3/.mcp.json

@@ -0,0 +1,37 @@
+{
+  "mcpServers": {
+    "serena": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena-mcp-server",
+        "--context",
+        "ide-assistant",
+        "--project",
+        "/home/rick/projects-caddy/claude-code-proxy-api",
+        "--enable-web-dashboard",
+        "false"
+      ],
+      "env": {}
+    },
+    "context7": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp"
+      ]
+    },
+    "zen": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/BeehiveInnovations/zen-mcp-server.git",
+        "zen-mcp-server"
+      ],
+      "env": {}
+    }
+  }
+}

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/.pre-commit-config.yaml

@@ -52,6 +52,12 @@ repos:
           - types-PyYAML>=6.0.12.12
           - sqlmodel>=0.0.24
           - duckdb-engine>=0.17.0
+          - tomli>=2.0.0
+          - fastapi-mcp>=0.1.0
+          - sse-starlette>=1.0.0
+          - textual>=3.7.1
+          - aiofiles>=24.1.0
+          - types-aiofiles>=24.0.0
         args: [--config-file=pyproject.toml]
         exclude: ^(docs/|examples/)
 
@@ -96,7 +102,7 @@ repos:
       - id: debug-statements
       - id: name-tests-test
         args: [--pytest-test-first]
-        exclude: ^tests/(fixtures|factories)/
+        exclude: ^tests/(fixtures|factories|helpers)/
 
   # Security checks
   # - repo: https://github.com/PyCQA/bandit

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/CHANGELOG.md

@@ -5,24 +5,56 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2025-07-25
+
+### Added
+
+- **Version Update Checking**: Automatic version checking against GitHub releases with configurable intervals (default 12 hours) and startup checks
+- **MCP Server Integration**: Added Model Context Protocol (MCP) server functionality with permission checking tools for Claude Code integration
+- **Permission System**: Implemented comprehensive permission management with REST API endpoints and Server-Sent Events (SSE) streaming for real-time permission requests
+- **Request/Response Logging**: Added comprehensive logging middleware with configurable verbosity levels (`CCPROXY_VERBOSE_API`, `CCPROXY_REQUEST_LOG_DIR`)
+- **Claude SDK Custom Content Blocks**: Added support for `system_message`, `tool_use_sdk`, and `tool_result_sdk` content blocks with full metadata preservation
+- **Model Mapping Utilities**: Centralized model provider abstraction with unified mapping logic in `ccproxy/utils/models_provider.py`
+- **Terminal Permission Handler**: Interactive permission workflow handler for CLI-based permission management
+- **Claude SDK Field Rendering**: Added flexible content handling with `forward`, `formatted`, and `ignore` rendering options for Claude SDK fields
+
+### Changed
+
+- **Claude SDK Integration**: Refactored to use native ThinkingBlock models from Claude Code SDK
+- **Models Endpoint**: Centralized `/v1/models` endpoint implementation to eliminate code duplication across routes
+- **OpenAI Adapter**: Enhanced with improved modularization and streaming architecture
+- **Logging System**: Migrated to canonical structlog pattern for structured, consistent logging
+- **SSE Streaming**: Improved Server-Sent Events format with comprehensive examples and better error handling
+
+### Fixed
+
+- **SDK Double Content**: Resolved duplicate content issue in Claude SDK message processing
+- **Error Handling**: Enhanced error handling throughout Claude SDK message processing pipeline
+- **Type Safety**: Improved type checking across permission system components
+- **Permission Handler**: Fixed lazy initialization issues in terminal permission handler
+
 ## [0.1.2] - 2025-07-22
 
 ### Added
+
 - **Permission Mode Support**: Restored `--permission-mode` option supporting default, acceptEdits, and bypassPermissions modes
 - **Custom Permission Tool**: Restored `--permission-prompt-tool-name` option to specify custom permission tool names
 - **Permission Response Models**: Added `PermissionToolAllowResponse` and `PermissionToolDenyResponse` models with proper JSON serialization
 
 ### Changed
+
 - **Message Formatting**: Modified `MessageConverter.combine_text_parts()` to join text parts with newlines instead of spaces, preserving formatting in multi-line content
 - **Settings Integration**: Enhanced OptionsHandler to apply default Claude options from settings before API parameters
 - **Configuration**: Extended settings to persist permission_mode and permission_prompt_tool_name
 
 ### Fixed
+
 - **Claude SDK Options**: Integrated Settings dependency into ClaudeSDKService to support configuration-based options
 
 ## [0.1.1] - 2025-07-22
 
 ### Added
+
 - **Conditional Authentication**: API endpoints now support optional authentication - when `SECURITY__AUTH_TOKEN` is configured, authentication is enforced; when not configured, the proxy runs in open mode.
 - **Startup Validation**: Added comprehensive validation checks during application startup:
   - Validates OAuth credentials and warns about expired tokens
@@ -32,6 +64,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Alternative Entry Point**: Added `ccproxy-api` as an alternative command-line entry point.
 
 ### Changed
+
 - **Authentication Variable**: Renamed environment variable from `AUTH_TOKEN` to `SECURITY__AUTH_TOKEN` for better namespace organization and clarity.
 - **Credential Priority**: Reordered credential search paths to prioritize ccproxy-specific credentials before Claude CLI paths.
 - **CLI Syntax**: Migrated all CLI parameters to modern Annotated syntax for better type safety and IDE support.
@@ -39,11 +72,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Documentation**: Improved Aider integration docs with correct API endpoint URLs and added installation options (uv, pipx).
 
 ### Fixed
+
 - **Authentication Separation**: Fixed critical issue where auth token was incorrectly used for both client and upstream authentication - now client auth token is separate from OAuth credentials.
 - **URL Paths**: Fixed documentation to use `/api` endpoints for Aider compatibility instead of SDK mode paths.
 - **Default Values**: Fixed default values for list parameters in CLI (docker_env, docker_volume, docker_arg).
 
 ### Removed
+
 - **Status Endpoints**: Removed redundant `/status` endpoints from both Claude SDK and proxy routes.
 - **Permission Tool**: Removed Claude permission tool functionality and related CLI options (`--permission-mode`, `--permission-prompt-tool-name`) that are no longer needed.
 - **Deprecated Options**: Removed references to deprecated permission_mode and permission_prompt_tool_name from documentation.
@@ -55,12 +90,14 @@ This is the initial public release of the CCProxy API.
 ### Added
 
 #### Core Functionality
+
 - **Personal Claude Access**: Enables using a personal Claude Pro, Team, or Enterprise subscription as an API endpoint, without needing separate API keys.
 - **OAuth2 Authentication**: Implements the official Claude OAuth2 flow for secure, local authentication.
 - **Local Proxy Server**: Runs a lightweight FastAPI server on your local machine.
 - **HTTP/HTTPS Proxy Support**: Full support for routing requests through an upstream HTTP or HTTPS proxy.
 
 #### API & Compatibility
+
 - **Dual API Support**: Provides full compatibility with both Anthropic and OpenAI API specifications.
 - **Anthropic Messages API**: Native support for the Anthropic Messages API at `/v1/chat/completions`.
 - **OpenAI Chat Completions API**: Compatibility layer for the OpenAI Chat Completions API at `/openai/v1/chat/completions`.
@@ -70,6 +107,7 @@ This is the initial public release of the CCProxy API.
 - **Health Check**: A `/health` endpoint for monitoring the proxy's status.
 
 #### Configuration & CLI
+
 - **Unified `ccproxy` CLI**: A single, user-friendly command-line interface for managing the proxy.
 - **TOML Configuration**: Configure the server using a `config.toml` file with JSON Schema validation.
 - **Keyring Integration**: Securely stores and manages OAuth credentials in the system's native keyring.
@@ -78,11 +116,13 @@ This is the initial public release of the CCProxy API.
 - **Docker Support**: A `Dockerfile` and `docker-compose.yml` for running the proxy in an isolated containerized environment.
 
 #### Security
+
 - **Local-First Design**: All processing and authentication happens locally; no conversation data is stored or transmitted to third parties.
 - **Credential Security**: OAuth tokens are stored securely in the system keyring, not in plaintext files.
 - **Header Stripping**: Automatically removes client-side `Authorization` headers to prevent accidental key leakage.
 
 #### Developer Experience
+
 - **Comprehensive Documentation**: Includes a quick start guide, API reference, and setup instructions.
 - **Pre-commit Hooks**: Configured for automated code formatting and linting to ensure code quality.
 - **Modern Tooling**: Uses `uv` for package management and `devenv` for a reproducible development environment.

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/Makefile

@@ -146,8 +146,15 @@ lint:
 	uv run ruff check .
 
 lint-fix: format
-	uv run ruff check --fix .
+	# fix F401 (unused import) errors
+	uv run ruff check --select F401 --fix .
+	# fix sort (import) errors
 	uv run ruff check --select I --fix .
+	# classic fix
+	uv run ruff check --fix .
+	# unsafe fix
+	uv run ruff check --unsafe-fixes --fix .
+	uv run ruff format .
 
 typecheck:
 	uv run mypy .

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/PKG-INFO

@@ -1,13 +1,15 @@
 Metadata-Version: 2.4
 Name: ccproxy-api
-Version: 0.1.2
+Version: 0.1.3
 Summary: API server that provides an Anthropic and OpenAI compatible interface over Claude Code, allowing to use your Claude OAuth account or over the API.
 License-File: LICENSE
 Requires-Python: >=3.11
+Requires-Dist: aiofiles>=24.1.0
 Requires-Dist: aiosqlite>=0.21.0
 Requires-Dist: claude-code-sdk>=0.0.14
 Requires-Dist: duckdb-engine>=0.17.0
 Requires-Dist: duckdb>=1.1.0
+Requires-Dist: fastapi-mcp
 Requires-Dist: fastapi[standard]>=0.115.14
 Requires-Dist: httpx-sse>=0.4.1
 Requires-Dist: httpx>=0.28.1
@@ -21,6 +23,7 @@ Requires-Dist: rich-toolkit>=0.14.8
 Requires-Dist: rich>=13.0.0
 Requires-Dist: sqlmodel>=0.0.24
 Requires-Dist: structlog>=25.4.0
+Requires-Dist: textual>=3.7.1
 Requires-Dist: tomli>=2.0.0; python_version < '3.11'
 Requires-Dist: typer>=0.16.0
 Requires-Dist: typing-extensions>=4.0.0
@@ -32,7 +35,7 @@ Description-Content-Type: text/markdown
 `ccproxy` is a local reverse proxy server for Anthropic Claude LLM at `api.anthropic.com/v1/messages`. It allows you to use your existing Claude Max subscription to interact with the Anthropic API, bypassing the need for separate API key billing.
 
 The server provides two primary modes of operation:
-*   **SDK Mode (`/sdk`):** Routes requests through the local `claude-code-sdk`. This enables access to tools configured in your Claude environment.
+*   **SDK Mode (`/sdk`):** Routes requests through the local `claude-code-sdk`. This enables access to tools configured in your Claude environment and includes an integrated MCP (Model Context Protocol) server for permission management.
 *   **API Mode (`/api`):** Acts as a direct reverse proxy, injecting the necessary authentication headers. This provides full access to the underlying API features and model settings.
 
 It includes a translation layer to support both Anthropic and OpenAI-compatible API formats for requests and responses, including streaming.
@@ -126,6 +129,59 @@ export ANTHROPIC_API_KEY="dummy-key"
 ```
 
 
+## MCP Server Integration & Permission System
+
+In SDK mode, CCProxy automatically configures an MCP (Model Context Protocol) server that provides permission checking tools for Claude Code. This enables interactive permission management for tool execution.
+
+### Permission Management
+
+**Starting the Permission Handler:**
+```bash
+# In a separate terminal, start the permission handler
+ccproxy permission-handler
+
+# Or with custom settings
+ccproxy permission-handler --host 127.0.0.1 --port 8000
+```
+
+The permission handler provides:
+- **Real-time Permission Requests**: Streams permission requests via Server-Sent Events (SSE)
+- **Interactive Approval/Denial**: Command-line interface for managing tool permissions
+- **Automatic MCP Integration**: Works seamlessly with Claude Code SDK tools
+
+**Working Directory Control:**
+Control which project the Claude SDK API can access using the `--cwd` flag:
+```bash
+# Set working directory for Claude SDK
+ccproxy --claude-code-options-cwd /path/to/your/project
+
+# Example with permission bypass and formatted output
+ccproxy --claude-code-options-cwd /tmp/tmp.AZyCo5a42N \
+        --claude-code-options-permission-mode bypassPermissions \
+        --claude-sdk-message-mode formatted
+
+# Alternative: Change to project directory and start ccproxy
+cd /path/to/your/project
+ccproxy
+```
+
+### Claude SDK Message Formatting
+
+CCProxy supports flexible message formatting through the `sdk_message_mode` configuration:
+
+- **`forward`** (default): Preserves original Claude SDK content blocks with full metadata
+- **`formatted`**: Converts content to XML tags with pretty-printed JSON data
+- **`ignore`**: Filters out Claude SDK-specific content entirely
+
+Configure via environment variables:
+```bash
+# Use formatted XML output
+CLAUDE__SDK_MESSAGE_MODE=formatted ccproxy
+
+# Use compact formatting without pretty-printing
+CLAUDE__PRETTY_FORMAT=false ccproxy
+```
+
 ## Using with Aider
 
 CCProxy works seamlessly with Aider and other AI coding assistants:
@@ -200,6 +256,11 @@ The proxy exposes endpoints under two prefixes, corresponding to its operating m
     *   `GET /sdk/models`, `GET /api/models`
     *   `GET /sdk/status`, `GET /api/status`
     *   `GET /oauth/callback`
+*   **MCP & Permissions:**
+    *   `POST /mcp/permission/check` - MCP permission checking endpoint
+    *   `GET /permissions/stream` - SSE stream for permission requests
+    *   `GET /permissions/{id}` - Get permission request details
+    *   `POST /permissions/{id}/respond` - Respond to permission request
 *   **Observability (Optional):**
     *   `GET /metrics`
     *   `GET /logs/status`, `GET /logs/query`

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/README.md

@@ -3,7 +3,7 @@
 `ccproxy` is a local reverse proxy server for Anthropic Claude LLM at `api.anthropic.com/v1/messages`. It allows you to use your existing Claude Max subscription to interact with the Anthropic API, bypassing the need for separate API key billing.
 
 The server provides two primary modes of operation:
-*   **SDK Mode (`/sdk`):** Routes requests through the local `claude-code-sdk`. This enables access to tools configured in your Claude environment.
+*   **SDK Mode (`/sdk`):** Routes requests through the local `claude-code-sdk`. This enables access to tools configured in your Claude environment and includes an integrated MCP (Model Context Protocol) server for permission management.
 *   **API Mode (`/api`):** Acts as a direct reverse proxy, injecting the necessary authentication headers. This provides full access to the underlying API features and model settings.
 
 It includes a translation layer to support both Anthropic and OpenAI-compatible API formats for requests and responses, including streaming.
@@ -97,6 +97,59 @@ export ANTHROPIC_API_KEY="dummy-key"
 ```
 
 
+## MCP Server Integration & Permission System
+
+In SDK mode, CCProxy automatically configures an MCP (Model Context Protocol) server that provides permission checking tools for Claude Code. This enables interactive permission management for tool execution.
+
+### Permission Management
+
+**Starting the Permission Handler:**
+```bash
+# In a separate terminal, start the permission handler
+ccproxy permission-handler
+
+# Or with custom settings
+ccproxy permission-handler --host 127.0.0.1 --port 8000
+```
+
+The permission handler provides:
+- **Real-time Permission Requests**: Streams permission requests via Server-Sent Events (SSE)
+- **Interactive Approval/Denial**: Command-line interface for managing tool permissions
+- **Automatic MCP Integration**: Works seamlessly with Claude Code SDK tools
+
+**Working Directory Control:**
+Control which project the Claude SDK API can access using the `--cwd` flag:
+```bash
+# Set working directory for Claude SDK
+ccproxy --claude-code-options-cwd /path/to/your/project
+
+# Example with permission bypass and formatted output
+ccproxy --claude-code-options-cwd /tmp/tmp.AZyCo5a42N \
+        --claude-code-options-permission-mode bypassPermissions \
+        --claude-sdk-message-mode formatted
+
+# Alternative: Change to project directory and start ccproxy
+cd /path/to/your/project
+ccproxy
+```
+
+### Claude SDK Message Formatting
+
+CCProxy supports flexible message formatting through the `sdk_message_mode` configuration:
+
+- **`forward`** (default): Preserves original Claude SDK content blocks with full metadata
+- **`formatted`**: Converts content to XML tags with pretty-printed JSON data
+- **`ignore`**: Filters out Claude SDK-specific content entirely
+
+Configure via environment variables:
+```bash
+# Use formatted XML output
+CLAUDE__SDK_MESSAGE_MODE=formatted ccproxy
+
+# Use compact formatting without pretty-printing
+CLAUDE__PRETTY_FORMAT=false ccproxy
+```
+
 ## Using with Aider
 
 CCProxy works seamlessly with Aider and other AI coding assistants:
@@ -171,6 +224,11 @@ The proxy exposes endpoints under two prefixes, corresponding to its operating m
     *   `GET /sdk/models`, `GET /api/models`
     *   `GET /sdk/status`, `GET /api/status`
     *   `GET /oauth/callback`
+*   **MCP & Permissions:**
+    *   `POST /mcp/permission/check` - MCP permission checking endpoint
+    *   `GET /permissions/stream` - SSE stream for permission requests
+    *   `GET /permissions/{id}` - Get permission request details
+    *   `POST /permissions/{id}/respond` - Respond to permission request
 *   **Observability (Optional):**
     *   `GET /metrics`
     *   `GET /logs/status`, `GET /logs/query`

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/ccproxy/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.1.2'
-__version_tuple__ = version_tuple = (0, 1, 2)
+__version__ = version = '0.1.3'
+__version_tuple__ = version_tuple = (0, 1, 3)

{ccproxy_api-0.1.2 → ccproxy_api-0.1.3}/ccproxy/adapters/openai/__init__.py

@@ -4,7 +4,7 @@ This module provides the OpenAI adapter implementation for converting
 between OpenAI and Anthropic API formats.
 """
 
-from .adapter import OpenAIAdapter, map_openai_model_to_claude
+from .adapter import OpenAIAdapter
 from .models import (
     OpenAIChatCompletionResponse,
     OpenAIChoice,
@@ -24,7 +24,6 @@ from .streaming import OpenAISSEFormatter, OpenAIStreamProcessor
 __all__ = [
     # Adapter
     "OpenAIAdapter",
-    "map_openai_model_to_claude",
     # Models
     "OpenAIMessage",
     "OpenAIMessageContent",