Claudeus Plane MCP

Integrations

  • Supports Docker deployment for containerized execution of the MCP server.

  • Provides integration with GitHub for collaborative development, discussions, and repository management.

  • Enables AI-powered project management through Plane, providing tools for project creation, task management, team collaboration, and communication.

⚠️プライベートリポジトリ通知⚠️

これはSimHop IT & Media ABチームメンバー専用のプライベートリポジトリです。コードはMITライセンスの下で閲覧および利用可能ですが、現時点では一般の方からの貢献は受け付けておりません。リポジトリをフォークして独自のバージョンを作成することは可能ですが、ユーザーの混乱を避けるため、当社のパッケージと完全に同一または極端に類似したバージョンは作成しないでください。

🤘 クローデウス・プレーン MCP 🎸

「飛行機の世界で AI の力を解き放ち、MCP の卓越性の基準を確立しましょう!」 🖤

🎯 私たちの使命: AIでプロジェクト管理を向上させる

AIを活用したプロジェクト管理の急速な進化に伴い、Claudeus Plane MCPを導入いたします。これは、ClaudeのAI機能とPlaneのプロジェクト管理プラットフォームを強力に繋ぐ橋渡しとなるものです。私たちの使命は以下のとおりです。

  • ✅ Plane とのシームレスな AI 統合を実現
  • ✅ 自動化されたプロジェクト管理ワークフローを有効にする
  • ✅ AIアシスタンスによるチームコラボレーションの強化
  • ✅ タスクとリソース管理を効率化
  • ✅ MCP開発の新しい基準を設定する

なぜ Claudeus Plane MCP を選ぶのか?

このサーバーは、当社の成功した Claudeus WordPress MCP の基盤上に構築されており、同等のレベルを実現します。

  • 🎸 技術的優秀性: 厳密な型チェックによる TypeScript の完全なカバレッジ
  • 🎸 品質保証: 包括的なテストスイート (95% 以上のカバレッジ)
  • 🎸 プロトコル準拠: MCP 2024-11-05 仕様の完全実装
  • 🎸 セキュリティ: エンタープライズグレードのセキュリティ対策
  • 🎸 信頼性: 堅牢なエラー処理と回復
  • 🎸 ドキュメント: 詳細なガイドと例

🤘 飛行機を選んだ理由:テクニカル・シンフォニー

膨大な数のプロジェクト管理ソリューションの中から、Planeを選んだのは単なる決断ではなく、技術的な発見でした。PlaneがAIを活用したプロジェクト管理革命の完璧な基盤として際立っている理由は次のとおりです。

🎸 技術的卓越性とアーキテクチャ

  1. オープンソースの力
    • 完全なソースコードの透明性
    • 自由を保証するAGPL v3.0ライセンス
    • 積極的なコミュニティ貢献
    • Docker/Kubernetesによるセルフホスティング機能
  2. 最新のテクノロジースタック
    • 最先端技術を駆使して構築
    • クリーンでモジュール化されたアーキテクチャ
    • 拡張可能なプラグインシステム
    • APIファーストの設計哲学
  3. パフォーマンスとスケーラビリティ
    • 超高速応答時間
    • 効率的なデータベース操作
    • スマートなキャッシュメカニズム
    • 水平スケーリングのサポート

🎯 機能の柔軟性

従来のワークフローを強制するソリューションとは異なり、

特徴飛行機その他
ワークフローの柔軟性あらゆる方法論(アジャイル、ウォーターフォールなど)に適応特定の方法論に縛られることが多い
カスタマイズオープンアーキテクチャで完全にカスタマイズ可能ベンダー提供のオプションに限定
統合完全なアクセスを備えたオープンAPI制限されているか有料のAPIが多い
セルフホスティングデータとインフラストラクチャの完全な制御通常はクラウドのみ、または限定的なセルフホスティング

⚡ 開発速度

Plane のアーキテクチャにより、次のことが可能になります。

  • 迅速なイテレーション:迅速な機能開発と展開
  • 簡単な拡張:シンプルなプラグイン開発
  • APIエクセレンス:REST APIを網羅
  • リアルタイム更新: ライブ変更のための WebSocket サポート

🔒 セキュリティと制御

  1. データ主権
    • データの場所を完全に制御
    • ベンダーロックインなし
    • カスタムセキュリティポリシー
    • コンプライアンスの柔軟性
  2. 認証と承認
    • きめ細かな権限システム
    • 複数の認証方法
    • ロールベースのアクセス制御
    • APIキー管理

💰 費用対効果

側面飛行機従来のソリューション
ライセンスオープンソースユーザーあたりの価格設定が高額になることが多い
ホスティングセルフホストオプション通常はクラウドのみ
カスタマイズ無料かつ無制限有料のアドオンが必要になることが多い
APIの使用無制限通常は従量制/制限あり

🚀 将来を見据えたアーキテクチャ

Plane のデザインは、現代の開発ニーズに完全に適合しています。

  1. AI統合対応
    • AI統合に最適なクリーンなAPI設計
    • MLに最適な構造化データモデル
    • AI機能のための拡張可能なアーキテクチャ
    • AI支援のためのリアルタイム機能
  2. 近代の発展
    • TypeScript/Python バックエンド
    • Reactベースのフロントエンド
    • Dockerコンテナ化
    • Kubernetesオーケストレーション
  3. コミュニティパワー
    • 活発な開発コミュニティ
    • 定期的なアップデートと改善
    • 寄付を歓迎
    • 透明なロードマップ

🎸 メタルファクター

ヘビーメタルが従来の音楽の境界を打ち破ったように、Plane は従来のプロジェクト管理の制約を打ち破りました。

  • 自由:カバー曲を演奏するのではなく、自分のリフを書くのが好き
  • パワー:プロジェクト管理の運命を完全にコントロール
  • イノベーション:新しいワークフローと機能を作成する能力
  • コミュニティ: Metalコミュニティのような強力なオープンソース精神

🤘「企業のプロジェクト管理の世界において、Plane はゲームを変えるアンダーグラウンド メタル バンドのようなものです。生々しく、力強く、完全に本物です!」 - Amadeus

🔮 パートナーシップの可能性

Plane の哲学は当社のビジョンと完全に一致しています。

  1. オープンソースの卓越性
    • 両社とも透明性を重視している
    • 品質への共通のコミットメント
    • コミュニティ主導の開発
  2. イノベーションフォーカス
    • AIファーストの思考
    • 近代建築
    • 継続的な進化
  3. 技術的シナジー
    • API駆動型開発
    • 最新の技術スタック
    • パフォーマンス重視

だからこそ、Planeは単なる選択肢ではなく、プロジェクト管理分野における技術的なソウルメイトなのです。Claudeus Plane MCPを通じたAI統合と組み合わせることで、プロジェクト管理の世界を揺るがす効率性のシンフォニーを創り出しています!🤘

🚀 コア機能

🎯 プロジェクト管理

  • AI支援によるプロジェクトの作成と管理
  • プロジェクトのセットアップと構成の自動化
  • スマートなプロジェクトテンプレートとワークフロー

📋 タスク管理

  • AIを活用したタスク作成と割り当て
  • タスクの優先順位付けの自動化
  • スマートなタスク依存関係管理

👥 チームコラボレーション

  • インテリジェントなリソース割り当て
  • 自動チーム通知
  • スマートなワークロードバランス

💬 コミュニケーション

  • AI強化コメント管理
  • スマート通知システム
  • 自動ステータス更新

📖 クイックスタートガイド

前提条件

# Required Software Node.js ≥ 22.0.0 TypeScript ≥ 5.0.0 PNPM Plane instance with API access

インストール

# Clone the repository git clone https://github.com/deus-h/claudeus-plane-mcp # Install dependencies pnpm install # Build the project pnpm build # Configure Claude Desktop cp claude_desktop_config.json.example claude_desktop_config.json # Edit claude_desktop_config.json with your settings

構成

# Copy example configs cp .env.example .env cp plane-instances.json.example plane-instances.json # Edit .env and plane-instances.json with your settings

飛行機インスタンス.jsonの設定

統合するPlaneインスタンスを設定するには、 plane-instances.jsonファイルを使用します。以下にファイル構造の例を示します。

{ "instance-alias": { "baseUrl": "https://your-plane-instance.com/api/v1", "defaultWorkspace": "your-workspace-slug", "otherWorkspaces": ["workspace2", "workspace3"], "apiKey": "your-plane-api-key" } }

構成フィールド

  • baseUrl : Plane API のベース URL (必須)
  • defaultWorkspace : デフォルトのワークスペーススラッグ(必須)
  • otherWorkspaces : 追加のワークスペーススラッグの配列(オプション)
  • apiKey : あなたのPlane APIキー(必須)

🛠️ 開発

プロジェクト構造

src/ ├── api/ # Plane API integration │ ├── client/ # API client implementation │ ├── endpoints/ # Endpoint definitions │ └── types/ # API type definitions │ ├── mcp/ # MCP protocol implementation │ ├── server.ts # Core MCP server │ ├── transport/ # Transport handlers │ ├── tools.ts # Tool definitions │ └── types/ # MCP type definitions │ ├── tools/ # Tool implementations │ ├── projects/ # Project management │ ├── tasks/ # Task operations │ ├── users/ # User management │ └── comments/ # Comment handling │ └── prompts/ # AI prompt templates ├── projects/ # Project-related prompts ├── tasks/ # Task-related prompts └── analysis/ # Analysis prompts

利用可能なスクリプト

# Development pnpm dev # Start development server pnpm watch # Watch for changes pnpm inspector # Launch MCP Inspector # Testing pnpm test # Run tests pnpm test:watch # Watch tests pnpm test:coverage # Generate coverage # Building pnpm build # Build for production pnpm clean # Clean build files

🔒 セキュリティ

認証

  • APIキーベースの認証
  • 安全なトークン管理
  • リクエストの検証

データ保護

  • 暗号化された通信
  • 安全な構成の保存
  • 入力サニタイズ

🤝 貢献する

これはSimHop IT & Media AB開発チームが管理するプライベートリポジトリです。一般の方からの貢献は受け付けておりませんが、チームメンバーは以下の開発基準に沿って貢献していただけます。

  1. 機能ブランチを作成する ( feature/AmazingFeature )
  2. テストカバレッジを95%以上維持する
  3. TypeScriptとドキュメントの標準に従ってください
  4. レビューのためにPRを送信する

📄 ライセンス

MIT ライセンス - 著作権 (c) 2024 SimHop IT & Media AB

🎸 魔法の背後にあるチーム

SimHop IT & Media AB - イノベーションとメタルが出会う場所🤘

スウェーデンに拠点を置くSimHop IT & Media ABは、卓越した技術力と創造的な革新性を融合させています。当社のチームメンバーは以下のとおりです。

アマデウス・サミエル H.(CTO/リードソリューションアーキテクト)

  • コンピュータサイエンス修士号
  • 20年以上の優れた技術
  • Claudeus MCPサーバーの背後にいる巨匠

サイモン・マルキ(CEO)

  • 20年以上のビジネスリーダーシップ
  • 戦略計画の専門家
  • SimHopの成功を推進する先見の明のある人物

Amadeus Samiel H.により 🤘❤️ で作成されました。

🛠 MCP ツールリファレンス

ツールのカテゴリーと危険レベル

ツール名カテゴリ機能危険レベル
プロジェクト管理
claudeus_plane_projects__listプロジェクトすべてのプロジェクトを一覧表示する🟢 安全
claudeus_plane_projects__createプロジェクト新しいプロジェクトを作成する🟡 中程度
claudeus_plane_projects__updateプロジェクトプロジェクトの変更🟡 中程度
claudeus_plane_projects__deleteプロジェクトプロジェクトを削除する🔴 高い
タスク管理
claudeus_plane_tasks__listタスクすべてのタスクを一覧表示する🟢 安全
claudeus_plane_tasks__createタスク新しいタスクを作成する🟡 中程度
claudeus_plane_tasks__updateタスクタスクを変更する🟡 中程度
claudeus_plane_tasks__deleteタスクタスクを削除する🔴 高い
ユーザー管理
claudeus_plane_users__listユーザーすべてのユーザーを一覧表示する🟢 安全
claudeus_plane_users__inviteユーザー新しいユーザーを招待する🟡 中程度
claudeus_plane_users__updateユーザーユーザーロールの変更🟡 中程度
claudeus_plane_users__removeユーザーユーザーを削除する🔴 高い
コメント管理
claudeus_plane_comments__listコメントすべてのコメントを一覧表示する🟢 安全
claudeus_plane_comments__createコメントコメントを作成する🟡 中程度
claudeus_plane_comments__updateコメントコメントを編集🟡 中程度
claudeus_plane_comments__deleteコメントコメントを削除する🔴 高い

危険レベルの凡例

  • 🟢安全: 読み取り専用操作、データの変更なし
  • 🟡中程度: コンテンツを作成または変更しますが、元に戻すことができます
  • 🔴: 破壊的な操作またはシステム全体の変更

🎯 技術的な詳細

アーキテクチャの概要 🏗️

当社の技術アーキテクチャの各コンポーネントは、最大限の効率と信頼性を実現するように設計されています。

コアコンポーネント 🤘

成分責任主な特徴
APIレイヤー平面統合RESTクライアント、型安全性、レート制限
MCPプロトコルコミュニケーションJSON-RPC 2.0、双方向フロー
安全保護認証、暗号化、検証
ツールオペレーションプロジェクト、タスク、ユーザー、コメント
プロンプトAI統合テンプレート、コンテキスト認識

技術的な実装 🎸

特徴実装説明
型安全性タイプスクリプト完全な静的型付け、実行時検証
API処理REST/JSON-RPC効率的なリクエスト/レスポンス処理
イベントシステムイベントエミッター非同期イベント処理
エラー処理多層包括的なエラー管理
キャッシングインメモリ/Redisパフォーマンスの最適化

セキュリティ対策 🛡️

保護特徴
輸送TLS/SSL暗号化された通信
認証APIキー安全なトークン管理
検証スキーマベース入力/出力検証
暗号化AES-256データ保護
監査包括的なアクティビティ追跡

パフォーマンスチューニング 🚀

最適化技術説明
キャッシング多層レスポンスとクエリのキャッシュ
バッチ処理リクエストのグループ化API呼び出しの削減
圧縮GZIP/Brotliネットワーク最適化
クエリの最適化スマートフェッチ効率的なAPIクエリ
負荷分散分布スケール処理

エラーのカテゴリと処理 🎸

カテゴリコード範囲取り扱い
プロトコル-32600から-32603自動再試行無効なJSON-RPC
飛行機API1000-1999後退するAPIタイムアウト
安全2000-2999警告認証失敗
ツール3000-3999回復する操作失敗
システム4000~4999再起動資源枯渇

デザイン原則パワーコード🤘

原理説明実装
モジュール性疎結合独立コンポーネント
型安全性強い型付けTypeScript + 検証
安全ゼロトラスト多層保護
パフォーマンススピードメタル最適化された操作

🎸 プロのヒント: よく調整されたギターのように、各コンポーネントは最高のシュレッド能力を発揮するように正確に調整されています! ❤️

⚡ パフォーマンスメトリック

時間の節約

タスク手動プロセスクローデウスと結果
プロジェクトのセットアップ2時間2分✓ 98.3%
タスクの作成30分30秒✓ 98.3%
ユーザー管理1時間1分✓ 98.3%
一括更新4時間3分✓ 98.7%

コスト効率

リソース従来のコスト説明
プロジェクトマネージャー月額5000ドルプロジェクトのセットアップと管理
タスクマネージャー月額3000ドルタスクの追跡と更新
チームリーダー月額4000ドルリソースの割り当て
合計月額12,000ドルすべてのサービスを組み合わせた
クロード・プロ月額20ドルアントロピック
違い月額11,980ドルClaudeus Plane MCP をClaude Desktop ( MacWindows ) と併用した場合の潜在的な節約額

🎸 クロード デスクトップ統合

構成場所

Claude Desktop の構成ファイルは次の場所にあります。

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

⚠️重要: Claude Desktop で既に他の MCP サーバーが設定されている場合は、サンプルファイルを直接コピーしないでください。既存の設定が上書きされてしまいます。代わりに、次の手順に従ってください。

  1. 既存のClaude Desktopユーザーの場合:
    • Claude Desktop から既存の構成を開きます。
      • クロードメニューをクリック
      • 「設定...」を選択します
      • 左側のバーにある「開発者」をクリックします
      • 「設定の編集」をクリックします
    • または、テキストエディタで設定ファイルを直接開きます
    • Claudeus Plane MCP サーバー構成を既存のmcpServersオブジェクトに追加します。
  2. Claude Desktop を初めてご利用の場合: サンプル設定ファイルをコピーできます:
    # For macOS cp claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json # For Windows (in PowerShell) Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json

設定例

NPXセットアップ

{ "mcpServers": { "claudeus-plane-mcp": { "command": "npx", "args": [ "-y", "claudeus-plane-mcp" ], "env": { "PLANE_INSTANCES_PATH": "/absolute/path/to/your/plane-instances.json" } } } }

Docker のセットアップ 🐳

{ "mcpServers": { "claudeus-plane-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "--network=host", "--mount", "type=bind,src=/absolute/path/to/your/plane-instances.json,dst=/app/plane-instances.json", "--mount", "type=bind,src=/absolute/path/to/your/.env,dst=/app/.env", "mcp/plane", "--config", "/app/plane-instances.json" ] } } }

🎸 プロのヒント: /absolute/path/to/your/plane-instances.jsonを、設定ファイルへの実際のパスに置き換えてください。

設定後

  1. Claude Desktopを完全に再起動します
  2. 入力ボックスの右下にあるハンマー🔨アイコンを探します
  3. クリックすると利用可能な飛行機管理ツールが表示されます
  4. シュレッディングを始めましょう!🤘

トラブルシューティング

サーバーがClaudeに表示されない場合は:

  1. claude_desktop_config.jsonの構文を確認してください
  2. ファイルパスが絶対パスかつ有効であることを確認する
  3. Claude のログを次の場所で確認してください:
    • macOS: ~/Library/Logs/Claude
    • Windows: %APPDATA%\Claude\logs

⚠️ 問題点と検討事項

現在の制限と回避策

1. クロードデスクトップの応答制限

  • 問題: 複雑な操作中に Claude Desktop の最大応答長に達する可能性がある
  • 影響: 操作が中断され、ユーザーの介入が必要になる場合があります
  • 回避策:
    • Claude Desktop を設定して、タスクを小さなバッチに分割します。
    • Claudeデスクトップ設定 > 詳細設定:
      • 「最大応答長」を低い値に設定する
      • 「自動分割回答」を有効にする
    • 大規模な操作にはインスペクターUIを使用する

2. レート制限に関する考慮事項

  • 問題: Plane API にはレート制限があります
  • 影響: 一括操作が制限される可能性があります
  • 緩和
    • バッチ処理機能を使用する
    • リクエスト間に適切な遅延を実装する
    • レート制限情報については API レスポンス ヘッダーを監視します

3. メモリ管理

  • 問題: 大規模な操作では大量のメモリが消費される可能性がある
  • 影響: 潜在的なパフォーマンスの低下
  • ベストプラクティス:
    • 大規模操作中のシステムリソースを監視する
    • 大規模なデータセットにはページ区切りを使用する
    • クリーンアップルーチンを実装する

今後の改善

私たちは現在、以下のことに積極的に取り組んでいます。

  1. Claude Desktop の応答処理の改善
  2. 高度なレート制限管理
  3. メモリ最適化技術
  4. 強化されたエラー回復メカニズム

🎸 プロのヒント: 回避策とベスト プラクティスについては、GitHub のディスカッションを確認してください。

🎸 サポートとコミュニティ ❤️

  • GitHub ディスカッション: アイデアを共有し、問題を報告し、会話に参加しましょう
  • ドキュメント: 完全な技術ドキュメント
  • 例: サンプル実装

🎸 プロのヒント: GitHub ディスカッションを使用して、経験を共有したり、問題を報告したり、改善を提案したりしましょう。


プロジェクトマネージャーの賛歌

アマデウス&クロード


プレーンの広大な空間では、
タスクはスムーズに流れ、
AIの抱擁、
完璧なペースを設定します。

クロードの力によって、
プロジェクトが始動し、
コードの喜びの中で、
すべてが正しく同期されました。

マネージャーの夢、
AIとチーム、
上流で作業し、
金属の輝きのようです。


Amadeus Samiel H.により 🤘❤️ で作成されました。

ID: 6bd61kpzft