Project MCP Server

Project MCP Server

プロジェクト、タスク、マイルストーン、リソース、チームメンバーを構造化して表現できるようにする、プロジェクトのナレッジグラフ管理ツールを提供する MCP サーバーです。このサーバーは、プロジェクトマネージャーによる進捗の追跡、リスクの管理、リソースの割り当て、情報に基づく意思決定を支援します。

Features

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

Entities

Project MCP Server は、以下のエンティティタイプを認識します。

• project：関連するすべてのエンティティを格納するメインコンテナ
• task：完了する必要がある個々の作業項目
• milestone：プロジェクトの主要なチェックポイントまたは成果物
• resource：プロジェクトに必要な材料、ツール、アセット
• teamMember：プロジェクトに参加するメンバー
• note：ドキュメント、アイデア、所見
• document：正式なプロジェクト文書
• issue：問題または作業の妨げとなる要因
• risk：将来発生する可能性のある問題
• decision：プロジェクト中に行われた重要な選択
• dependency：外部要件または前提条件
• component：プロジェクトの部分またはモジュール
• stakeholder：プロジェクトの影響を受ける人、またはプロジェクトに関心を持つ人
• change：プロジェクトの範囲または要件への変更
• status：エンティティのステータス値（inactive、active、complete）
• priority：優先度の値（high、low）

Relationships

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

• part_of：あるエンティティが別のエンティティの構成要素またはサブセットであることを示します
• depends_on：エンティティ間の依存関係を示します
• assigned_to：タスクとチームメンバーを関連付けます
• created_by：エンティティの作成者を追跡します
• modified_by：エンティティを変更した人を記録します
• related_to：エンティティ間の一般的なつながりを示します
• blocks：あるエンティティが別のエンティティを妨げていることを示します
• manages：管理上の関係を示します
• contributes_to：エンティティへの貢献を示します
• documents：ドキュメントをエンティティに関連付けます
• scheduled_for：エンティティを日付または期間に関連付けます
• responsible_for：所有権または責任を割り当てます
• reports_to：報告関係を示します
• categorized_as：エンティティをカテゴリまたはタイプに関連付けます
• required_for：完了に必要な要件を示します
• discovered_in：課題を発見時の状況に関連付けます
• resolved_by：課題を解決したものを示します
• impacted_by：影響関係を示します
• stakeholder_of：ステークホルダーをプロジェクトまたはコンポーネントに関連付けます
• prioritized_as：優先度を示します
• has_status：エンティティを現在のステータス（inactive、active、complete）に関連付けます
• has_priority：エンティティを優先度（high、low）に関連付けます
• precedes：あるタスクが一連のタスクの中で別のタスクより先に行われることを示します

Available Tools

Project MCP Server は、プロジェクトのナレッジとやり取りするための以下のツールを提供します。

startsession

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

loadcontext

特定のエンティティ（プロジェクト、タスクなど）の詳細なコンテキストを読み込み、エンティティの種類に応じた関連情報を表示します。ステータス情報（inactive、active、complete）、優先度（high、low）、順次タスクの関係が含まれます。

endsession

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

1. summary：セッションの概要、所要時間、プロジェクトの重点を記録します
2. achievements：セッションでの主な成果を記録します
3. taskUpdates：既存のタスクの更新を追跡します
4. newTasks：セッション中に作成された新しいタスクを記録します
5. statusUpdates：エンティティのステータス値の変更を記録します
6. projectStatus：プロジェクト全体のステータス、優先度の割り当て、順次関係を更新します
7. assembly：すべてのセッションデータを最終的に組み立てます

buildcontext

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

• entities：プロジェクト関連の新しいエンティティ（プロジェクト、タスク、マイルストーン、ステータス、優先度など）を追加します
• relations：エンティティ間の関係（has_status、has_priority、precedes を含む）を作成します
• observations：既存のエンティティに観察事項を追加します

deletecontext

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

• entities：プロジェクトのエンティティを削除します
• relations：エンティティ間の関係（ステータス、優先度、順次関係を含む）を削除します
• observations：エンティティから特定の観察事項を削除します

advancedcontext

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

• graph：ナレッジグラフ全体を取得します
• search：クエリ条件に基づいてノードを検索します
• nodes：名前を指定して特定のノードを取得します
• related：関連するエンティティを検索します
• status：特定のステータス値（inactive、active、complete）を持つエンティティを検索します
• priority：特定の優先度（high、low）を持つエンティティを検索します
• sequence：タスクの順次関係を特定します

ドメイン固有の関数

Project MCP Server には、プロジェクト管理向けの専門的なドメイン関数が含まれています。

• getProjectOverview：タスク、マイルストーン、チームメンバー、課題などを含む、プロジェクトの包括的な概要を表示します
• getTaskDependencies：タスクの依存関係を分析し、ブロックされているタスクとクリティカルパスを特定します
• getTeamMemberAssignments：特定のチームメンバーに割り当てられたすべてのタスクを表示します
• getMilestoneProgress：プロジェクトのマイルストーンに向けた進捗を追跡します
• getProjectTimeline：プロジェクトのタイムラインと重要な日付を分析します
• getResourceAllocation：プロジェクト全体でのリソース配分を確認します
• getProjectRisks：プロジェクトのリスクを特定し、評価します
• findRelatedProjects：異なるプロジェクト間のつながりを見つけます
• getDecisionLog：意思決定の履歴とコンテキストを追跡します
• getProjectHealth：指標と推奨事項を用いて、プロジェクト全体の健全性を評価します
• getStatusOverview：特定のステータス（inactive、active、complete）を持つすべてのエンティティを表示します
• getPriorityItems：優先度の高いタスクや活動を特定します
• getTaskSequence：precedes リレーションに基づいて、タスクの順序を可視化します

プロンプトの例

セッションの開始

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"
    }
  }
}

docker

{
  "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：

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

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。MIT ライセンスの利用規約に従うことで、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。

環境変数

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

• 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