cacodes-mcp-server 0.2.9__py3-none-any.whl

cacodes_mcp_server-0.2.9.dist-info/METADATA

@@ -0,0 +1,424 @@
+Metadata-Version: 2.4
+Name: cacodes-mcp-server
+Version: 0.2.9
+Summary: Model Context Protocol server for Cacodes (Plane fork) integration
+Author-email: CaCodes <contato@cacodes.com.br>
+License: MIT
+Project-URL: Homepage, https://tarefas.cacodes.com.br/docs/developers/dev-tools/mcp
+Project-URL: Repository, https://github.com/Caiocesar173/plane
+Project-URL: Documentation, https://tarefas.cacodes.com.br/docs/developers/dev-tools/mcp
+Keywords: mcp,cacodes,plane,fastmcp,ai,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp==3.2.0
+Requires-Dist: plane-sdk==0.2.16
+Requires-Dist: py-key-value-aio[redis]<0.5.0,>=0.4.4
+Requires-Dist: mcp==1.26.0
+Requires-Dist: PyJWT>=2.12.0
+Requires-Dist: authlib>=1.6.9
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: fakeredis[lua]<2.35.0,>=2.32.1
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+
+# Plane MCP Server
+
+A Model Context Protocol (MCP) server for Plane integration. This server provides tools and resources for interacting with Plane through AI agents.
+
+## Features
+
+* 🔧 **Plane Integration**: Interact with Plane APIs and services
+* 🔌 **Multiple Transports**: Supports stdio, SSE, and streamable HTTP transports
+* 🌐 **Remote & Local**: Works both locally and as a remote service
+* 🛠️ **Extensible**: Easy to add new tools and resources
+
+## Usage
+
+The server supports three transport methods. **We recommend using `uvx`** as it doesn't require installation.
+
+**Requirements**:
+- **Python 3.10+** (for stdio transport, via `uvx`)
+- **Node.js 22+** (for remote transports, via `npx`)
+
+### 1. Stdio Transport (for local use)
+
+**MCP Client Configuration** (using uvx - recommended):
+
+```json
+{
+  "mcpServers": {
+    "plane": {
+      "command": "uvx",
+      "args": ["plane-mcp-server", "stdio"],
+      "env": {
+        "PLANE_API_KEY": "<your-api-key>",
+        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>",
+        "PLANE_BASE_URL": "https://api.plane.so"
+      }
+    }
+  }
+}
+```
+
+### 2. Remote HTTP Transport with OAuth
+
+Connect to the hosted Plane MCP server using OAuth authentication.
+
+**URL**: `https://mcp.plane.so/http/mcp`
+
+**MCP Client Configuration** (for tools like Claude Desktop without native remote MCP support):
+
+```json
+{
+  "mcpServers": {
+    "plane": {
+      "command": "npx",
+      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
+    }
+  }
+}
+```
+
+**Note**: OAuth authentication will be handled automatically when connecting to the remote server.
+
+### 3. Remote HTTP Transport using PAT Token
+
+Connect to the hosted Plane MCP server using a Personal Access Token (PAT).
+
+**URL**: `https://mcp.plane.so/http/api-key/mcp`
+
+**Headers**:
+- `Authorization: Bearer <PAT_TOKEN>`
+- `X-Workspace-slug: <SLUG>`
+
+**MCP Client Configuration** (for tools like Claude Desktop without native remote MCP support):
+
+```json
+{
+  "mcpServers": {
+    "plane": {
+      "command": "npx",
+      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
+      "headers": {
+        "Authorization": "Bearer <PAT_TOKEN>",
+        "X-Workspace-slug": "<SLUG>"
+      }
+    }
+  }
+}
+```
+
+### 4. SSE Transport (Legacy)
+
+⚠️ **Legacy Transport**: SSE (Server-Sent Events) transport is maintained for backward compatibility. New implementations should use the HTTP transport (sections 2 or 3) instead.
+
+Connect to the hosted Plane MCP server using OAuth authentication via Server-Sent Events.
+
+**URL**: `https://mcp.plane.so/sse`
+
+**MCP Client Configuration** (for tools that support SSE transport):
+
+```json
+{
+  "mcpServers": {
+    "plane": {
+      "command": "npx",
+      "args": ["mcp-remote@latest", "https://mcp.plane.so/sse"]
+    }
+  }
+}
+```
+
+**Note**: OAuth authentication will be handled automatically when connecting to the remote server. This transport is deprecated in favor of the HTTP transport.
+
+
+## Configuration
+
+### Authentication
+
+The server requires authentication via environment variables:
+
+- `PLANE_BASE_URL`: Base URL for Plane API (default: `https://api.plane.so`) - Optional
+- `PLANE_API_KEY`: API key for authentication (required for stdio transport)
+- `PLANE_WORKSPACE_SLUG`: Workspace slug identifier (required for stdio transport)
+- `PLANE_ACCESS_TOKEN`: Access token for authentication (alternative to API key)
+
+**Example** (for stdio transport):
+```bash
+export PLANE_BASE_URL="https://api.plane.so"
+export PLANE_API_KEY="your-api-key"
+export PLANE_WORKSPACE_SLUG="your-workspace-slug"
+```
+
+**Note**: For remote HTTP transports (OAuth or PAT), authentication is handled via the connection method (OAuth flow or PAT headers) and does not require these environment variables.
+
+## Available Tools
+
+The server provides comprehensive tools for interacting with Plane. All tools use Pydantic models from the Plane SDK for type safety and validation.
+
+### Projects
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_projects` | List all projects in a workspace with optional pagination and filtering |
+| `create_project` | Create a new project with name, identifier, and optional configuration |
+| `retrieve_project` | Retrieve a project by ID |
+| `update_project` | Update a project with partial data |
+| `delete_project` | Delete a project by ID |
+| `get_project_worklog_summary` | Get work log summary for a project |
+| `get_project_members` | Get all members of a project |
+| `update_project_features` | Update features configuration of a project |
+
+### Work Items
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_items` | List all work items in a project with optional filtering and pagination |
+| `create_work_item` | Create a new work item with name, assignees, labels, and other attributes |
+| `retrieve_work_item` | Retrieve a work item by ID with optional field expansion |
+| `retrieve_work_item_by_identifier` | Retrieve a work item by project identifier and issue sequence number |
+| `update_work_item` | Update a work item with partial data |
+| `delete_work_item` | Delete a work item by ID |
+| `search_work_items` | Search work items across a workspace with query string |
+
+### Cycles
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_cycles` | List cycles in a project (set `archived=true` for archived) |
+| `create_cycle` | Create a new cycle with name, dates, and owner |
+| `retrieve_cycle` | Retrieve a cycle by ID |
+| `update_cycle` | Update a cycle with partial data |
+| `delete_cycle` | Delete a cycle by ID |
+| `manage_cycle_work_items` | Add and/or remove work items on a cycle |
+| `list_cycle_work_items` | List work items in a cycle |
+| `transfer_cycle_work_items` | Transfer work items from one cycle to another |
+| `manage_cycle_archive` | Archive or unarchive a cycle |
+
+### Modules
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_modules` | List modules in a project (set `archived=true` for archived) |
+| `create_module` | Create a new module with name, dates, status, and members |
+| `retrieve_module` | Retrieve a module by ID |
+| `update_module` | Update a module with partial data |
+| `delete_module` | Delete a module by ID |
+| `manage_module_work_items` | Add and/or remove work items on a module |
+| `list_module_work_items` | List work items in a module |
+| `manage_module_archive` | Archive or unarchive a module |
+
+### Initiatives
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_initiatives` | List all initiatives in a workspace |
+| `create_initiative` | Create a new initiative with name, dates, state, and lead |
+| `retrieve_initiative` | Retrieve an initiative by ID |
+| `update_initiative` | Update an initiative with partial data |
+| `delete_initiative` | Delete an initiative by ID |
+
+### Intake Work Items
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_intake_work_items` | List all intake work items in a project with optional pagination |
+| `create_intake_work_item` | Create a new intake work item in a project |
+| `retrieve_intake_work_item` | Retrieve an intake work item by work item ID with optional field expansion |
+| `update_intake_work_item` | Update an intake work item with partial data |
+| `delete_intake_work_item` | Delete an intake work item by work item ID |
+
+### Work Item Properties
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_properties` | List work item properties for a work item type |
+| `create_work_item_property` | Create a new work item property with type, settings, and validation rules |
+| `retrieve_work_item_property` | Retrieve a work item property by ID |
+| `update_work_item_property` | Update a work item property with partial data |
+| `delete_work_item_property` | Delete a work item property by ID |
+
+### Milestones
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_milestones` | List all milestones in a project |
+| `create_milestone` | Create a new milestone |
+| `retrieve_milestone` | Retrieve a milestone by ID |
+| `update_milestone` | Update a milestone by ID |
+| `delete_milestone` | Delete a milestone by ID |
+| `manage_milestone_work_items` | Add and/or remove work items on a milestone |
+| `list_milestone_work_items` | List work items in a milestone |
+
+### Labels
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_labels` | List all labels in a project |
+| `create_label` | Create a new label |
+| `retrieve_label` | Retrieve a label by ID |
+| `update_label` | Update a label by ID |
+| `delete_label` | Delete a label by ID |
+
+### States
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_states` | List all states in a project |
+| `create_state` | Create a new state |
+| `retrieve_state` | Retrieve a state by ID |
+| `update_state` | Update a state by ID |
+| `delete_state` | Delete a state by ID |
+
+### Work Item Comments
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_comments` | List comments for a work item |
+| `retrieve_work_item_comment` | Retrieve a specific comment for a work item |
+| `create_work_item_comment` | Create a comment for a work item |
+| `update_work_item_comment` | Update a comment for a work item |
+| `delete_work_item_comment` | Delete a comment for a work item |
+
+### Work Item Links
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_links` | List links for a work item |
+| `retrieve_work_item_link` | Retrieve a specific link for a work item |
+| `create_work_item_link` | Create a link for a work item |
+| `update_work_item_link` | Update a link for a work item |
+| `delete_work_item_link` | Delete a link for a work item |
+
+### Work Item Types
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_types` | List all work item types in a project |
+| `create_work_item_type` | Create a new work item type |
+| `retrieve_work_item_type` | Retrieve a work item type by ID |
+| `update_work_item_type` | Update a work item type by ID |
+| `delete_work_item_type` | Delete a work item type by ID |
+| `import_work_item_types_to_project` | Bulk-link workspace-level work item types to a project |
+| `resolve_work_item_type` | Find or create a named type for a project, auto-handling workspace vs project scope and import |
+
+### Work Item Relations
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_relations` | List relations for a work item |
+| `create_work_item_relation` | Create relations for a work item |
+| `remove_work_item_relation` | Remove a relation from a work item |
+
+### Work Item Activities
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_item_activities` | List activities for a work item |
+| `retrieve_work_item_activity` | Retrieve a specific activity for a work item |
+
+### Work Logs
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_work_logs` | List work logs for a work item |
+| `create_work_log` | Create a work log for a work item |
+| `update_work_log` | Update a work log for a work item |
+| `delete_work_log` | Delete a work log for a work item |
+
+### Pages
+
+| Tool Name | Description |
+|-----------|-------------|
+| `list_pages` | List pages (workspace, or a project's if `project_id` given) |
+| `retrieve_page` | Retrieve a page by ID (workspace, or project's if `project_id` given) |
+| `create_page` | Create a workspace or project page |
+
+### Workspaces
+
+| Tool Name | Description |
+|-----------|-------------|
+| `get_workspace_members` | Get all members of the current workspace |
+| `get_features` | Get feature flags (workspace, or a project's if `project_id` given) |
+| `update_workspace_features` | Update features of the current workspace |
+
+### Users
+
+| Tool Name | Description |
+|-----------|-------------|
+| `get_me` | Get current authenticated user information |
+
+**Total Tools**: 100+ tools across 20 categories
+
+## Development
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Code Formatting
+
+```bash
+black plane_mcp/
+ruff check plane_mcp/
+```
+
+## License
+
+MIT License - see LICENSE for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Deprecation Notice
+
+⚠️ **The Node.js-based `plane-mcp-server` is deprecated and no longer maintained.**
+
+This repository represents the new Python+FastMCP based implementation of the Plane MCP server. If you were using the previous Node.js version, please migrate to this Python-based version for continued support and updates.
+
+The new implementation offers:
+- Better type safety with Pydantic models
+- Improved performance with FastMCP
+- Enhanced tool coverage
+- Active maintenance and development
+
+For migration assistance, please refer to the configuration examples in this README or open an issue for support.
+
+**Old Node.js Configuration (Deprecated):**
+
+If you were using the previous Node.js-based `@makeplane/plane-mcp-server`, your configuration looked like this:
+
+```json
+{
+  "mcpServers": {
+    "plane": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@makeplane/plane-mcp-server"
+      ],
+      "env": {
+        "PLANE_API_KEY": "<YOUR_API_KEY>",
+        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED>",
+        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
+      }
+    }
+  }
+}
+```
+
+**Please migrate to the new Python-based configuration shown in the Usage section above.**
+

cacodes_mcp_server-0.2.9.dist-info/RECORD

@@ -0,0 +1,40 @@
+plane_mcp/__init__.py,sha256=FiUOxQD6H_F6Aty5HrXCvd_aZJZcVjLkqDAxlSMfnrA,80
+plane_mcp/__main__.py,sha256=NzDCOi4n4M5hRKNejHLlx-WOXUlfV2-Un5l39Yqm-54,6061
+plane_mcp/aws_secrets.py,sha256=s0_doZeOGxAEdZTDYU8qNl8VztSVtzsHIpZBUvdbkNM,3098
+plane_mcp/client.py,sha256=kJMsZzAFeAzKtfg4FT70w6VNUAWiC7oEqLwVmSheCIc,2513
+plane_mcp/instructions.py,sha256=r5wm6IA-LzTWcNmUbUCD_ChvNuJxQBfvh1fDvSANeiw,1261
+plane_mcp/server.py,sha256=4J-9c8Z-G5XZ-fTxqD94BGmXtgCX-p7_TIWBt0gu_Vs,2809
+plane_mcp/storage.py,sha256=StpA72xZ1schJfzgR7LD7MDBDzB8HgUmIkymbyPfJUU,5993
+plane_mcp/auth/__init__.py,sha256=K7w0oX7nHjDwA5JtKr_ulqE15yF9xLibb1S8n0gdm-g,217
+plane_mcp/auth/plane_header_auth_provider.py,sha256=hnH3AreCZeOwM2QEJc_-SUH-UwBkjSwBn6z-7D-l1Fk,2829
+plane_mcp/auth/plane_oauth_provider.py,sha256=4G8JgFdztQSw60j3uOD3JyrKnJm4ZW1dIXFvnVqqirA,14714
+plane_mcp/extensions/__init__.py,sha256=FV5lR_qzXYwv-yyuPDQPNG5xTDUfVsrzkvjC1NJg5bI,146
+plane_mcp/extensions/templates.py,sha256=z2nCE-mwNF-M0ASB_Ml3BnVnAJdFNFy2PX_TwU9KQBA,2023
+plane_mcp/tools/__init__.py,sha256=3rQ52JDmAWkR1vmCWmksL6_YRxnSGh5xn1t2gX8vznM,2376
+plane_mcp/tools/cycles.py,sha256=FJt3cLjPB6MIHLo-3LleZuxPhvc3w75Fe009wcTh2vc,12857
+plane_mcp/tools/initiatives.py,sha256=vhe2GIsP7QQhWR5kMCObzbs2wCMonli2nZGMnaxi-mY,7850
+plane_mcp/tools/intake.py,sha256=t8Wsdc9fNF190pWxwdQthOf4SGkNrrlMkV7VvKSqThQ,5988
+plane_mcp/tools/labels.py,sha256=k8i-61JqUHjGL1YaShAJuO1caC5_kfJqzNV40PVSejw,4528
+plane_mcp/tools/milestones.py,sha256=npIB41mhzbsQpaYhchjgFzzauGm4b7aO5xUDcGt3FSE,6299
+plane_mcp/tools/modules.py,sha256=f2QkwEFOpgzmNP45brnsHwdcxg3f6BFmxi91d4Fo9ck,11368
+plane_mcp/tools/pages.py,sha256=JMwnwjXrYGT1qj2u9WFPLtmLdaAj_ZDF6STy3NzL8YE,6202
+plane_mcp/tools/pql.py,sha256=WWB3QgskCPfDkTDsw481OaAYUpaa3ZY1H7IvFs_av_Q,1216
+plane_mcp/tools/pql_reference.py,sha256=HID-tI4mc_msfTu7mm5hnR2fqBNawqSwguS6DEk_4nM,16878
+plane_mcp/tools/projects.py,sha256=8Rb0nm1n0Mbl5fAFSAMgQVRTwPme4tS35-ix7UxctxI,21196
+plane_mcp/tools/states.py,sha256=D6-U124AtlheHrxnYFAv9amFMi--YNGVQulExaCRac8,5499
+plane_mcp/tools/users.py,sha256=0FCnV9IsFFsVGFPpTuJAsIpQC6Zlgj0BD2xaXhwxwzc,571
+plane_mcp/tools/work_item_activities.py,sha256=8aBQdcyeXMVQ7aBmexpWrhb3vqysHNF9z2d47GQT0v8,1947
+plane_mcp/tools/work_item_attachments.py,sha256=3XE1sNxaVDd_ZAPKACTBM6r0Du3Jln7hW770r4lf2nc,14965
+plane_mcp/tools/work_item_comments.py,sha256=wmOcut3-eS2G5jWTgnpku775n6y5GYB8g4u9NqfL4NU,5925
+plane_mcp/tools/work_item_links.py,sha256=v2nJXRNdrfpVynQtOEv7bte87vqfk057lsrQNObs34U,4027
+plane_mcp/tools/work_item_properties.py,sha256=KY8AOzWpc35dCTLsS8a0lwMdputbV7PTcsVHA6ptStU,27834
+plane_mcp/tools/work_item_relations.py,sha256=06v4eM0UXZv0UrCn6GaRueTMKIoQ7oWymPcvkxqui1E,4296
+plane_mcp/tools/work_item_types.py,sha256=PVEP9GxBC44UF8KCSdbbTzVK1BbkJEfzSJz9o1wdz2s,10787
+plane_mcp/tools/work_items.py,sha256=01vcv2-5eycsAuyrJbP-AEkhN-uJYv6Wc3ItVtysilc,26522
+plane_mcp/tools/work_logs.py,sha256=8rvoLS-mH6sv3uJV-22uO_mI_g2rY2UNBZ9MpFHsV4Q,3778
+plane_mcp/tools/workspaces.py,sha256=GNeN5gv24iux8a9BtfzcrrIWeMjFmzNbPIkmrtrcn8E,3069
+cacodes_mcp_server-0.2.9.dist-info/METADATA,sha256=d_DAuuZO2zguZyHfn03M9xUNDiLveOBD9_hvroOLw1w,14711
+cacodes_mcp_server-0.2.9.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+cacodes_mcp_server-0.2.9.dist-info/entry_points.txt,sha256=HRwdvQ3Hao-HN4LkKvbUPpTzCuujC_xNnBZDa7iDzzc,106
+cacodes_mcp_server-0.2.9.dist-info/top_level.txt,sha256=HlNwe99scg9OD2UWbDrcLlew2X3LEvUjvvoBiOW1w1M,10
+cacodes_mcp_server-0.2.9.dist-info/RECORD,,

cacodes_mcp_server-0.2.9.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

cacodes_mcp_server-0.2.9.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cacodes-mcp-server = plane_mcp.__main__:main
+plane-mcp-server = plane_mcp.__main__:main

cacodes_mcp_server-0.2.9.dist-info/top_level.txt

@@ -0,0 +1 @@
+plane_mcp

plane_mcp/__init__.py

@@ -0,0 +1 @@
+"""Plane MCP Server - A Model Context Protocol server for Plane integration."""

plane_mcp/__main__.py

@@ -0,0 +1,178 @@
+"""Main entry point for the Plane MCP Server."""
+
+import json
+import logging
+import os
+import sys
+from contextlib import asynccontextmanager
+from datetime import datetime, timezone
+from enum import Enum
+
+import uvicorn
+from fastmcp.server.dependencies import get_access_token
+from starlette.applications import Starlette
+from starlette.middleware.cors import CORSMiddleware
+from starlette.routing import Mount
+
+from plane_mcp.server import get_header_mcp, get_oauth_mcp, get_stdio_mcp
+
+
+class UserContextFilter(logging.Filter):
+    """Attach the authenticated user's id to every log record.
+
+    Pulls the current request's access token via FastMCP's dependency, which
+    returns None (never raises) outside a request context — so startup logs and
+    stdio mode simply carry no user info. Only the opaque user id is recorded;
+    PII such as the display name / email is intentionally never logged.
+    """
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        user_id = None
+        try:
+            token = get_access_token()
+            if token:
+                user_id = token.claims.get("sub")
+        except Exception as exc:
+            # Never let logging enrichment break a request, but leave a signal.
+            record.user_context_enrichment_error = type(exc).__name__
+        record.user_id = user_id
+        return True
+
+
+class JSONFormatter(logging.Formatter):
+    """JSON log formatter for structured logging (Datadog, ELK, etc.)."""
+
+    def format(self, record: logging.LogRecord) -> str:
+        log_entry = {
+            "timestamp": datetime.fromtimestamp(record.created, tz=timezone.utc).isoformat(),
+            "level": record.levelname,
+            "logger": record.name,
+            "message": record.getMessage(),
+        }
+        user_id = getattr(record, "user_id", None)
+        if user_id:
+            log_entry["user_id"] = user_id
+        err = getattr(record, "user_context_enrichment_error", None)
+        if err:
+            log_entry["user_context_enrichment_error"] = err
+        if record.exc_info and record.exc_info[1]:
+            log_entry["error"] = {
+                "type": type(record.exc_info[1]).__name__,
+                "message": str(record.exc_info[1]),
+            }
+        return json.dumps(log_entry)
+
+
+def configure_json_logging():
+    """Replace FastMCP's Rich handlers with a JSON formatter on the fastmcp logger."""
+    fastmcp_logger = logging.getLogger("fastmcp")
+
+    # Remove all existing handlers (Rich)
+    for handler in fastmcp_logger.handlers[:]:
+        fastmcp_logger.removeHandler(handler)
+
+    handler = logging.StreamHandler(sys.stderr)
+    handler.setFormatter(JSONFormatter())
+    handler.addFilter(UserContextFilter())
+    fastmcp_logger.addHandler(handler)
+    fastmcp_logger.setLevel(logging.INFO)
+    fastmcp_logger.propagate = False
+
+
+configure_json_logging()
+
+logger = logging.getLogger("fastmcp.plane_mcp")
+
+
+class ServerMode(Enum):
+    STDIO = "stdio"
+    SSE = "sse"
+    HTTP = "http"
+
+
+@asynccontextmanager
+async def combined_lifespan(oauth_app, header_app, sse_app):
+    """Combine lifespans from both OAuth and Header MCP apps."""
+    # Start both lifespans
+    async with oauth_app.lifespan(oauth_app):
+        async with header_app.lifespan(header_app):
+            async with sse_app.lifespan(sse_app):
+                yield
+
+
+def main() -> None:
+    """Run the MCP server."""
+    server_mode = ServerMode.STDIO
+    if len(sys.argv) > 1:
+        server_mode = ServerMode(sys.argv[1])
+
+    if server_mode == ServerMode.STDIO:
+        # Validate API_KEY and PLANE_WORKSPACE_SLUG are set
+        if not os.getenv("PLANE_API_KEY"):
+            raise ValueError("PLANE_API_KEY is not set")
+        if not os.getenv("PLANE_WORKSPACE_SLUG"):
+            os.environ["PLANE_WORKSPACE_SLUG"] = "cacodes"
+
+        get_stdio_mcp().run()
+        return
+
+    if server_mode == ServerMode.HTTP:
+        prefix = os.getenv("MCP_PATH_PREFIX") or ""
+
+        oauth_mcp = get_oauth_mcp(prefix + "/http")
+        oauth_app = oauth_mcp.http_app(stateless_http=True)
+        header_app = get_header_mcp().http_app(stateless_http=True)
+
+        sse_mcp = get_oauth_mcp(prefix)
+        sse_app = sse_mcp.http_app(transport="sse")
+
+        # mcp_path is appended to the auth provider's base_url to form the
+        # advertised resource URL. base_url already carries the prefix, so these
+        # stay at /mcp and /sse to avoid double-prefixing.
+        oauth_well_known = oauth_mcp.auth.get_well_known_routes(mcp_path="/mcp")
+        sse_well_known = sse_mcp.auth.get_well_known_routes(mcp_path="/sse")
+
+        app = Starlette(
+            routes=[
+                # Well-known routes for OAuth and Header HTTP
+                *oauth_well_known,
+                *sse_well_known,
+                # Mount both MCP servers
+                Mount(prefix + "/http/api-key", app=header_app),
+                Mount(prefix + "/http", app=oauth_app),
+                Mount(prefix or "/", app=sse_app),
+            ],
+            lifespan=lambda app: combined_lifespan(oauth_app, header_app, sse_app),
+        )
+
+        app.add_middleware(
+            CORSMiddleware,
+            allow_origins=["*"],
+            allow_credentials=False,
+            allow_methods=["*"],
+            allow_headers=["*"],
+        )
+
+        # Configure uvicorn loggers to use JSON formatting too
+        for uv_logger_name in ("uvicorn", "uvicorn.error"):
+            uv_logger = logging.getLogger(uv_logger_name)
+            for h in uv_logger.handlers[:]:
+                uv_logger.removeHandler(h)
+            uv_handler = logging.StreamHandler(sys.stderr)
+            uv_handler.setFormatter(JSONFormatter())
+            uv_handler.addFilter(UserContextFilter())
+            uv_logger.addHandler(uv_handler)
+
+        logger.info("Starting HTTP server at URLs: /mcp and /header/mcp")
+        uvicorn.run(
+            app,
+            host="0.0.0.0",
+            port=8211,
+            log_level="info",
+            access_log=False,
+        )
+        return
+
+
+if __name__ == "__main__":
+    main()

plane_mcp/auth/__init__.py

@@ -0,0 +1,7 @@
+from plane_mcp.auth.plane_header_auth_provider import PlaneHeaderAuthProvider
+from plane_mcp.auth.plane_oauth_provider import PlaneOAuthProvider
+
+__all__ = [
+    "PlaneHeaderAuthProvider",
+    "PlaneOAuthProvider",
+]