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

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

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

Name: Claudeus Plane MCP
Author: deus-h

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

ライセンスノード GitHubスター NPMバージョン NPMダウンロード GitHubディスカッション GitHubフォーク鍛冶屋のバッジ 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を活用したプロジェクト管理革命の完璧な基盤として際立っている理由は次のとおりです。

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

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

🎯 機能の柔軟性

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

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

⚡ 開発速度

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

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

🔒 セキュリティと制御

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

💰 費用対効果

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

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

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

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

🎸 メタルファクター

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

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

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

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

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

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

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

Related MCP server: Plane MCP Server

🚀 コア機能

🎯 プロジェクト管理

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開発チームが管理するプライベートリポジトリです。一般の方からの貢献は受け付けておりませんが、チームメンバーは以下の開発基準に沿って貢献していただけます。

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

📄 ライセンス

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

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
飛行機API	1000-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 ( Mac 、 Windows ) と併用した場合の潜在的な節約額

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

構成場所

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

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

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

既存のClaude Desktopユーザーの場合:
- Claude Desktop から既存の構成を開きます。
  - クロードメニューをクリック
  - 「設定...」を選択します
  - 左側のバーにある「開発者」をクリックします
  - 「設定の編集」をクリックします
- または、テキストエディタで設定ファイルを直接開きます
- Claudeus Plane MCP サーバー構成を既存のmcpServersオブジェクトに追加します。
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を、設定ファイルへの実際のパスに置き換えてください。

設定後

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

トラブルシューティング

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

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

⚠️ 問題点と検討事項

現在の制限と回避策

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

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

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

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

3. メモリ管理

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

今後の改善

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

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

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

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

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

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

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

アマデウス＆クロード

プレーンの広大な空間では、

クロードの力によって、

マネージャーの夢、