feat: add fastmcp based MCP server (#54)

* chore: delete all previous ts based mcp server

* feat: add new mcp server in python using fastmcp

- Supports both self-hosted (using stdio) and cloud using
stdio and http transports.
- Stdio supports PAT based auth and http transport uses OAuth

* delete old node github actions

* add gh action to publish to pypi

* use workspace_slug from env or oauth token

* fix fetching installation flow

* add docker files

* feat: add support to run oauth, header and stdio based mcp servers

* refactor code for each of the mcp server

* fix env variables in stdio transport

* update docker command to use http transport

* add info logs in oauth provider

* fix: downgrade mcp to 1.22.0 version

* formatting changes

* use /api-key as path for header based mcp

* update README with instructions on using python mcp

* remove rest of the node files

* upgrade fastmcp to latest version

* Update server name and icon

* add SSE transport for backward compatibility

* add intake tools

* add docs for intake tools

* add sse documentation

* set version as 0.2.0

Author: Prashant-Surya

.dockerignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Git
+.git/
+.gitignore
+
+# Documentation
+*.md
+!README.md
+
+# Other
+.DS_Store
+*.log
+.codacy/
+.cursor/
+test_client.py
+

.github/workflows/build_check.yml

@@ -0,0 +1,58 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: |
+          python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          python -m twine upload dist/*
+
+      - name: Get version from pyproject.toml
+        id: package-version
+        run: |
+          VERSION=$(grep "version = " pyproject.toml | cut -d'"' -f2 | head -1)
+          if [ -z "$VERSION" ]; then
+            echo "Error: Could not extract version from pyproject.toml"
+            exit 1
+          fi
+          echo "current-version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.package-version.outputs.current-version }}
+          name: v${{ steps.package-version.outputs.current-version }}
+          draft: false
+          prerelease: false
+          generate_release_notes: true

.github/workflows/ci.yml

@@ -1,39 +1,57 @@
-# Dependencies
-node_modules/
-yarn.lock
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Build output
-dist/
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
 build/
-out/
-
-# Logs
-logs/
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# IDE and editor files
-.idea/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDE
 .vscode/
+.idea/
 *.swp
 *.swo
+*~
 .DS_Store
 
-# TypeScript
-*.tsbuildinfo
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
 
-# Coverage directory used by tools like istanbul
-coverage/
+# Mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
 
-# Optional npm cache directory
-.npm
+# Environment variables
+.env
+.env.local
 
-# Optional eslint cache
-.eslintcache
+# Ignore cursor AI rules
+.cursor/rules/codacy.mdc

.github/workflows/publish-pypi.yml

@@ -0,0 +1,33 @@
+# Use Python 3.11 as base image
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv for faster package management
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+# Copy dependency files and application code
+COPY pyproject.toml ./
+COPY uv.lock* ./
+COPY plane_mcp/ ./plane_mcp/
+
+# Install the package and dependencies using uv
+RUN uv pip install --system --no-cache .
+
+# Expose port for HTTP transports (SSE, streamable-http, http)
+EXPOSE 8211
+
+# Set environment variables with defaults
+ENV FASTMCP_PORT=8211
+
+# Default to streamable-http transport, but allow override via command
+# Users can override by passing different transport as CMD
+ENTRYPOINT ["python", "-m", "plane_mcp"]
+CMD ["http"]
+

.github/workflows/publish.yml

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Plane
+Copyright (c) 2025 Plane MCP Server Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +19,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+