makeplane/plane-mcp-server

Plane MCP Server – 概要

Plane MCP Server は、AIエージェントが Model Context Protocol (MCP) を介して Plane プロジェクト管理プラットフォームと通信できるようにする小さなPythonサービスです。LLMベースのアシスタントが理解する一般的なMCP呼び出しを、公式の plane-sdk を使用してPlaneのREST APIへの具体的な呼び出しに変換します。

AIエージェントにとっての重要性

ツール駆動エージェント – 最新のLLMエージェント（Claude、ChatGPTなど）は、モデル外のアクションを実行するためにツールを使用します。このサーバーは30以上の「ツール」を公開しており、各ツールはPlaneのリソース（プロジェクト、作業項目、サイクル、リリース、顧客など）と一連のアクション（作成、一覧表示、アーカイブなど）を表します。
自己文書化 – 各ツールは実行時にそのアクションと必要なパラメータを通知するため、エージェントはスキーマをハードコーディングせずに何ができるかを発見できます。
複数のトランスポート – サーバーはローカルサブプロセス（stdio）またはHTTPエンドポイント（OAuthまたはAPIキー認証）として実行できます。これは、現在のMCP対応クライアントの構築方法に一致します。

コア機能（READMEに記載）

機能	詳細
30ツール	Planeリソースごとに1つ、合計207の個別操作をカバー。
トランスポートオプション	• `stdio` – MCPクライアントの子プロセスとして実行。 • HTTP + OAuth – ホストエンドポイント `https://mcp.plane.so/http/mcp`。 • HTTP + パーソナルアクセストークン – `https://mcp.plane.so/http/api-key/mcp`。 • SSE – 非推奨、後方互換性のために維持。
認証	• APIキー（`PLANE_API_KEY`）をstdio用に使用。 • OAuthフローはホスト型HTTPトランスポートで自動処理。 • ベアラートークン（`Authorization: Bearer <PAT>`）をAPIキーHTTPトランスポート用に使用。
クエリ言語	作業項目の一覧表示やカウント時に強力なフィルタリングのためのPlaneのPQLをサポート。
互換性レイヤー	古い操作ごとのツール名（177のうち169）は引き続き解決されるため、既存のプロンプトやスクリプトは動作し続けます。
設定可能なプロキシ	添付ファイルアップロードURLに対して`HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY`を尊重。
ロギング	構造化JSONログ。ユーザー情報とペイロードのオプション包含。
開発のしやすさ	オフラインテストスイート、`ruff`によるリンティング、明確なコントリビューションガイドライン。

典型的な使用フロー

Plane APIトークンを取得（またはOAuthに依存）。
MCPクライアントを構成し、plane-mcp-serverを起動するコマンド（例：uvx plane-mcp-server stdio）を設定。
クライアントは workitem(action="list", project_id=…, pql='state__group = "started"') のようなMCPリクエストを送信。
サーバーはそれを plane-sdk への呼び出しに変換し、結果を返し、呼び出しをログに記録。

誰が使うか？

LLM搭載アシスタント – Planeワークスペースを読み取りまたは変更する必要がある（例：「プロジェクトマネージャーボット」）。
IDE拡張機能（VS Code、Cursor、Claude.aiコネクタ） – チャットベースのワークフローにPlaneアクションを公開。
カスタム自動化 – 開発者が生のPlane SDKコードを書く代わりに安定したMCPエンドポイントを望む場合。

ライセンスとコミュニティ

このプロジェクトはMITライセンスであり、プルリクエストを歓迎し、オフラインで実行できる完全なテストスイートを提供します。これは古いNode.js実装を置き換え、機能をPythonパッケージに統合します。

上記の情報はすべてリポジトリのREADMEから直接取得したものであり、外部の前提は追加されていません。