プロジェクトMCPサーバー

プロジェクトナレッジグラフを管理するためのツールを提供するMCPサーバー実装。プロジェクト、タスク、マイルストーン、リソース、チームメンバーを構造的に表現できます。このサーバーは、プロジェクトマネージャーが進捗状況を追跡し、リスクを管理し、リソースを割り当て、情報に基づいた意思決定を行うのに役立ちます。

特徴

永続的なプロジェクトコンテキスト: 複数のセッションにわたってプロジェクトエンティティと関係の構造化された知識グラフを維持します。
セッション管理: 固有のIDを使用してプロジェクト管理セッションを追跡し、時間の経過に伴う進捗を記録します。
プロジェクトステータスの追跡: プロジェクトの健全性、リスク、問題のステータスをリアルタイムで監視します
タスクの依存関係: タスク間の依存関係を視覚化して管理し、ボトルネックを特定します。
マイルストーンの進捗: 主要なプロジェクトマイルストーンの進捗を追跡します
リソース割り当て: プロジェクトやタスク間でリソースがどのように配分されているかを監視します
リスク評価: プロジェクトのリスクを特定、監視、軽減する
意思決定ログ: プロジェクトの重要な決定とその背景を記録する
チームメンバー管理: チームメンバーの割り当てと作業負荷を追跡します
プロジェクトタイムライン分析: クリティカルパスを含むプロジェクトタイムラインを分析

エンティティ

Project MCP サーバーは次のエンティティタイプを認識します。

プロジェクト: 関連するすべてのエンティティのメインコンテナ
タスク: 完了する必要がある個々の作業項目
マイルストーン: プロジェクトにおける主要なチェックポイントまたは成果物
リソース: プロジェクトに必要な材料、ツール、または資産
チームメンバー: プロジェクトに関わる人々
注記: 文書、アイデア、または観察
文書：正式なプロジェクト文書
問題: 問題または障害
リスク: 将来起こりうる問題
決定: プロジェクト中に行われた重要な選択
依存性: 外部要件または前提条件
コンポーネント: プロジェクトの一部またはモジュール
ステークホルダー：プロジェクトの影響を受ける人、またはプロジェクトに関心のある人
変更: プロジェクトの範囲または要件の変更
ステータス: エンティティのステータス値 (非アクティブ、アクティブ、完了)
優先度: 優先度の値（高、低）

人間関係

エンティティは、次の関係タイプを通じて接続できます。

part_of : エンティティが別のエンティティのコンポーネント/サブセットであることを示します
depends_on : エンティティ間の依存関係を表示します
assignment_to : タスクをチームメンバーにリンクする
created_by : エンティティを作成した人を追跡します
changed_by : エンティティを変更した人の記録
related_to : エンティティ間の一般的な接続を表示します
ブロック: あるエンティティが別のエンティティをブロックしていることを示します
管理: 管理関係を表示します
contributes_to : エンティティへの貢献を表示します
ドキュメント: ドキュメントをエンティティにリンクします
scheduled_for : エンティティを日付または期間に接続します
責任者: 所有権/責任を割り当てる
reports_to : 報告関係を示す
categorized_as : エンティティをカテゴリまたはタイプにリンクします
required_for : 完了に必要な要件を表示します
discover_in : 問題を検出コンテキストにリンクします
解決済み: 問題を解決した内容を表示します
influenced_by : 影響関係を表示する
stakeholder_of : ステークホルダーをプロジェクト/コンポーネントにリンクします
prioritized_as : 優先度レベルを示す
has_status : エンティティを現在のステータス（非アクティブ、アクティブ、完了）にリンクします。
has_priority : エンティティを優先度レベル（高、低）にリンクします。
先行: あるタスクが他のタスクよりも先に実行されることを示します

利用可能なツール

Project MCP サーバーは、プロジェクトナレッジと対話するための次のツールを提供します。

開始セッション

新しいプロジェクト管理セッションを開始し、一意のセッションIDを生成して、現在のプロジェクト、タスク、マイルストーン、リスク、最近のセッションを表示します。has_status リレーションを介してステータス情報、has_priority リレーションを介して優先度レベルを表示し、順序依存関係に基づいて次に作業する準備が整ったタスクを特定します。

ロードコンテキスト

特定のエンティティ（プロジェクト、タスクなど）の詳細なコンテキストを読み込み、エンティティの種類に基づいて関連情報を表示します。ステータス情報（非アクティブ、アクティブ、完了）、優先度（高、低）、およびタスク間の関係が含まれます。

終了セッション

構造化された多段階のプロセスを通じてプロジェクト管理セッションの結果を記録します。

概要: セッションの概要、期間、プロジェクトの焦点を記録します
成果: セッションの主要な成果を文書化する
taskUpdates : 既存のタスクの更新を追跡します
newTasks : セッション中に作成された新しいタスクを記録します
statusUpdates : エンティティのステータス値の変更を記録します
projectStatus : プロジェクト全体のステータス、優先度の割り当て、および順序関係を更新します
アセンブリ: すべてのセッションデータの最終アセンブリ

ビルドコンテキスト

ナレッジグラフに新しいエンティティ、リレーション、または観察を作成します。

エンティティ: 新しいプロジェクト関連のエンティティ (プロジェクト、タスク、マイルストーン、ステータス、優先度など) を追加します。
リレーション：エンティティ間の関係を作成する（has_status、has_priority、precedesを含む）
観察: 既存のエンティティに観察を追加する

削除コンテキスト

ナレッジグラフからエンティティ、リレーション、または観察を削除します。

エンティティ: プロジェクトエンティティを削除する
関係: エンティティ間の関係（ステータス、優先度、順序関係を含む）を削除します。
観測: エンティティから特定の観測を削除する

高度なコンテキスト

ナレッジグラフから情報を取得します。

グラフ: ナレッジグラフ全体を取得する
検索: クエリ条件に基づいてノードを検索する
nodes : 名前で特定のノードを取得する
関連: 関連するエンティティを検索する
ステータス: 特定のステータス値 (非アクティブ、アクティブ、完了) を持つエンティティを検索します。
優先度: 特定の優先度値（高、低）を持つエンティティを検索します
シーケンス: タスクの順序関係を識別する

ドメイン固有の機能

Project MCP サーバーには、プロジェクト管理用の特殊なドメイン機能が含まれています。

getProjectOverview : タスク、マイルストーン、チームメンバー、問題などを含むプロジェクトの包括的なビュー。
getTaskDependencies : タスクの依存関係を分析して、ブロックされたタスクとクリティカルパスを特定します
getTeamMemberAssignments : 特定のチームメンバーのすべての割り当てを表示する
getMilestoneProgress : プロジェクトのマイルストーンの進捗状況を追跡する
getProjectTimeline : プロジェクトのタイムラインと重要な日付を分析する
getResourceAllocation : プロジェクト全体でリソースがどのように割り当てられているかを調べる
getProjectRisks : プロジェクトリスクの特定と評価
findRelatedProjects : 異なるプロジェクト間のつながりを発見する
getDecisionLog : 意思決定の履歴とコンテキストを追跡する
getProjectHealth : 指標と推奨事項を使用してプロジェクト全体の健全性を評価する
getStatusOverview : 特定のステータス（非アクティブ、アクティブ、完了）のすべてのエンティティを表示します。
getPriorityItems : 優先度の高いタスクとアクティビティを特定する
getTaskSequence : 先行関係に基づいてタスクの順序を視覚化する

プロンプトの例

セッションの開始

Let's start a new project management session to review the Mobile App Development project.

プロジェクトコンテキストの読み込み

Load the context for the Mobile App Development project so I can see its current status.

レコーディングセッションの結果

I've just finished a project review meeting for Mobile App Development. We completed the UI design milestone, identified 2 new risks related to the backend API, and assigned 3 new tasks to the development team. The UI tasks are now marked as complete, and we've set the API development tasks as high priority. The project is still on track but we need to monitor the API risks closely.

プロジェクト知識の管理

Create a new task called "Implement User Authentication" that's part of the Mobile App Development project, assigned to Sarah, with high priority and due in two weeks. Set its status to active and make it precede the "User Profile" task.

Update the status of the "Database Migration" task to "completed" and add an observation that it was finished ahead of schedule.

使用法

この MCP サーバーにより、プロジェクトマネージャーは次のことが可能になります。

コンテキストの継続性を維持: 複数の計画セッションにわたってプロジェクトの詳細を追跡します
新しいチームメンバーのオンボード: 新しいチームメンバーにプロジェクトの状況を迅速に把握してもらう
セッション結果の記録: 会議や作業セッションの結果を文書化します
依存関係の追跡: 重要な依存関係とボトルネックを特定して管理します
リスクの監視: プロジェクトのリスクを追跡し、軽減戦略を実施する
リソースの割り当て: プロジェクトとタスク間でのリソースの割り当てを最適化します
情報に基づいた意思決定:包括的なプロジェクトデータに基づいて意思決定を行う
進捗状況の追跡: プロジェクトのライフサイクル全体を通じてエンティティのステータスを監視します
仕事の優先順位付け: 優先度の高いタスクを特定して集中する
タスクの順序付け: プロジェクトタスクの論理的な順序を計画し、視覚化します

構成

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

GitHubからインストールしてnpxで実行する

{
  "mcpServers": {
    "project": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/project"
      ]
    }
  }
}

グローバルにインストールして直接実行

まず、パッケージをグローバルにインストールします。

npm install -g github:tejpalvirk/project

次に、Claude Desktop を構成します。

{
  "mcpServers": {
    "project": {
      "command": "contextmanager-project"
    }
  }
}

ドッカー

{
  "mcpServers": {
    "project": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/project"
      ]
    }
  }
}

建物

ソースから

# Clone the repository
git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager

# Install dependencies
npm install

# Build the server
npm run build

# Run the server
cd project
node project_index.js

ドッカー:

docker build -t mcp/project -f project/Dockerfile .

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

環境変数

Project MCP サーバーは、データの保存場所をカスタマイズするために次の環境変数をサポートしています。

MEMORY_FILE_PATH : ナレッジグラフデータが保存されるパス
- 絶対パスまたは相対パスを指定できます（相対パスは現在の作業ディレクトリを使用します）
- デフォルト: ./project/memory.json
SESSIONS_FILE_PATH : セッションデータが保存されるパス
- 絶対パスまたは相対パスを指定できます（相対パスは現在の作業ディレクトリを使用します）
- デフォルト: ./project/sessions.json

使用例:

# Store data in the current directory
MEMORY_FILE_PATH="./pm-memory.json" SESSIONS_FILE_PATH="./pm-sessions.json" npx github:tejpalvirk/contextmanager-project

# Store data in a specific location (absolute path)
MEMORY_FILE_PATH="/path/to/data/project-memory.json" npx github:tejpalvirk/contextmanager-project

# Store data in user's home directory
MEMORY_FILE_PATH="$HOME/contextmanager/project-memory.json" npx github:tejpalvirk/contextmanager-project

Project MCP Server

Integrations