Plane (Rust)

plane-mcp-rs

Planeのプロジェクト管理に対応した、高速な単一バイナリのModel Context Protocol（MCP）サーバーです。 Claude、Cursor、CodexなどのAIエージェントが、Planeの作業項目、コメント、サイクル、モジュール、ページなどを扱えるようにします。

MITライセンスのPython製plane-mcp-serverをRustに移植したものです。同じ30個のツールとツールスキーマを備え、メモリ使用量は約16分の1で、Pythonランタイムも不要です。

非公式です。 コミュニティプロジェクトであり、Planeとは提携しておらず、Planeの承認も受けていません。

MCP Registry名：mcp-name: io.github.ninerf/plane-mcp-rs

インストール

Releasesからバイナリをダウンロードし、PATHに配置してください。MCPバンドルに対応したクライアントでは、同じページからplane-mcp-rs.mcpbをインストールできます。または、Rustでビルドしてください。

cargo install --git https://github.com/ninerf/plane-mcp-rs

設定

変数	必須	意味
PLANE_API_KEY	はい	Plane APIキー（Profile → Personal Access Tokens）
PLANE_WORKSPACE_SLUG	はい	PlaneのURLに含まれるワークスペースのスラッグ
PLANE_BASE_URL	いいえ	セルフホスト環境のURL。既定値はhttps://api.plane.soです

Claude Code

claude mcp add plane -e PLANE_API_KEY=your-key -e PLANE_WORKSPACE_SLUG=your-slug -- plane-mcp-rs --stdio

Cursor、Claude Desktop、その他のJSON設定クライアント

{
  "mcpServers": {
    "plane": {
      "command": "plane-mcp-rs",
      "args": ["--stdio"],
      "env": { "PLANE_API_KEY": "your-key", "PLANE_WORKSPACE_SLUG": "your-slug" }
    }
  }
}

共有HTTPサーバー

1つのプロセスで、マシン上のすべてのエージェントにサービスを提供できます。127.0.0.1のみにバインドされ、独自の認証機能はないため、ポートを外部に公開しないでください。

plane-mcp-rs --port 8096

エンドポイントはhttp://127.0.0.1:8096/servers/plane/mcpです。

ツール

workitem、workitem_comment、workitem_activity、workitem_link、workitem_relation、workitem_attachment、 workitem_type、workitem_property、work_log、project、project_estimate、state、label、member、 workspace、module、cycle、milestone、intake、page、collection、template、initiative、customer、 customer_property、customer_request、release、release_label、release_tag、get_pql_reference。

上流サーバーで廃止されたツール名（create_work_itemなど169個のエイリアス）も引き続き動作します。

Pythonサーバーとの違い

• workitem listは、fieldsを指定しない限り説明を省略するため、出力はおよそ半分になります。項目全体を取得するにはretrieveを使用してください。
• 結果はテキストとして1回だけ送信され、重複するstructuredContentのコピーはありません。
• Planeの生のレスポンスをそのまま返すため、Pythonモデルが追加するnullのプレースホルダーフィールドは含まれません。
• 空のリストは[]として返されます。
• upload_from_urlは、解決されたすべてのアドレスとすべてのリダイレクトについて、プライベートネットワークへのアクセスを確認します。
• APIキーによるログインのみ対応しています。OAuthとホスト型モードには対応していません。

パフォーマンス

Windows 11の1台のワークステーションから、セルフホスト型Planeインスタンス1台を対象に測定しました。公平に比較するため、plane-mcp-server 0.3.3にはすでに調整を加えています（サーバープロセス1つ、mcp-proxyなし、ペイロードのログ記録なし、同じ軽量なworkitem list）。標準のインストールでは、より多くのリソースを使用します。測定値は環境によって異なります。

	Rust	Python
アイドル時のメモリ（ワーキングセット）	7.6 MB	127.9 MB	17分の1
負荷後のメモリ	12.8 MB	135.8 MB	11分の1
起動からリスニング開始まで¹	約0.5秒	約7.2秒	14倍高速
ローカルツール呼び出し、p50	1.09 ms	16.82 ms	15倍高速
tools/list、p50	2.78 ms	8.9 ms	3倍高速
workitem list（20項目）、p50²	約686 ms	約728 ms	ほぼ同等
workitem list（20項目）、レスポンス	8.6 KB	16.5 KB	48％削減
インストールサイズ	1.7 MB、1ファイル	109.8 MB、8,769ファイル
クライアントに送信されるツールスキーマ	66.5 KB	66.5 KB	同一

¹ 計測ループ自体のオーバーヘッドを含むため、Rustの値は上限です。 ² 大部分はPlane自体によるものなので、Rustでも大幅な高速化はできません。呼び出し間隔を設けて測定し、その待機時間は差し引いています。

スキーマは意図的に同一であるため、Rustにしてもツールスキーマのコストは減りません。レイテンシとサイズの測定値はbench/bench.pyで再現できます。

互換性とテスト状況

セルフホストした Plane 1.4.2 でテスト済みです。

• 読み取りと検証： 全 30 ツールで 77 回呼び出し、Python サーバーと比較した結果、上記に記載したものを除き、動作の違いはありませんでした。各ツールを対象としていますが、すべてのアクションを対象としているわけではありません。
• 書き込み、エンドツーエンド： 作業項目、メンションを含むコメント、リンク、添付ファイル、ラベル、状態。
• この Plane バージョンでは両サーバーで同じ 404 が返されます： 作業項目の関連付けとアーカイブ。エディションによって異なる場合があります。
• エンドツーエンドでは未テスト： 顧客、リリース、イニシアチブ、ページ、サイクル、モジュール、テンプレート、作業ログなど、その他のツールの書き込みアクションです。これらは上流の SDK のルートに従います。失敗するものがあれば、イシューを作成してください。

Linux と macOS のビルドは CI でコンパイルされ、単体テストが実行されます。上記のエンドツーエンドテストは Windows のみで実施しました。

クレジット

ツールのスキーマ、説明、PQL のリファレンステキストは plane-mcp-server（MIT）に由来します。LICENSE を参照してください。