Execution System MCP

🚀 実行システムMCPサーバー

Claudeとモデルコンテキストプロトコルによって駆動されるAIネイティブな実行システムです。

このシステムが存在する理由

従来の生産性ツールでは、思考と実行の間でコンテキストを切り替える必要があります。作業を中断し、アプリを開き、メニューを操作し、フォームに入力してから、元の作業に戻るという手順を踏みます。この摩擦のため、多くの場合、情報を捕捉できなかったり、後で整理する必要のある不完全なエントリを作成したりします。

このMCPサーバーは、そのような摩擦を解消します。作業中にClaudeとの会話を続けることができ、実行システムは自然に更新されます。

• コード作業中？ "Add action: refactor the auth module @macbook +api-redesign due:2025-11-15"
• 会議中？ "Add to waiting: Sarah's feedback on the proposal"
• 週の振り返り？ "List all actions for the ml-refresh project"
• 計画中？ "Show me all Health projects that haven't been reviewed in 7 days"

アプリの切り替えやフォームの入力は必要ありません。自然な言語で、厳格な実行システムを維持しながら作業の流れを維持できます。

✨ 主な機能

サーバーは、モデルコンテキストプロトコルを通じて焦点レベルモデルを実装しています。

0k - 次のアクション（基礎レベル）

• 自動的なプロジェクト検証を伴い、コンテキストファイル（@macbook、@phone、@errands）にアクションを追加する
• 特殊リストに追加：@waiting（他人への待ち事）、@deferred（特定の未来の日付）、@incubating（いつか/多分）
• 行番号でアクションを完了し、自動的にcompleted.mdにアーカイブする
• コンテキスト、プロジェクト、状態で柔軟にフィルタリングしてアクションを一覧表示する
• 状態とコンテキストのフィルターを使用してテキストでアクションを検索する
• 作成日、コンテキスト、プロジェクト、期限/延期日を持つtodo.txt形式を完全にサポートする

10k - プロジェクト（現在の取り組み）

• YAMLフロントマターと3つのテンプレート（標準、調整、習慣）でプロジェクトを作成する
• エリア、期限、またはフラットで柔軟にフィルタリングしてグループ化してプロジェクトを一覧表示する
• タイトルまたは内容のテキストでプロジェクトを検索する
• すべてのアクションが完了していることを検証してプロジェクトを完了する
• ライフサイクルを管理する：インキュベーターからアクティブにする、インキュベーターに戻す、スコープを縮小する
• メタデータを更新する：期限、エリア、タイプ、レビュー日（一括更新をサポート）
• 監査ツール：データ品質を検証し、孤立したプロジェクト/アクションを見つけ、レビューが必要な項目を特定する

20k - 焦点エリア（責任範囲）

• 設定から焦点エリアを一覧表示する
• すべてのプロジェクトと目標にわたって自動的にエリアを検証する

30k - 目標（1 - 2年の目標）

• アクティブとインキュベーターフォルダから目標を一覧表示する
• YAMLフロントマターのtype: goalで自動的にフィルタリングする
• サポート資料を持つネストされた目標ディレクトリをサポートする

すべてのツールには、包括的な検証、エラー処理、およびプログラムによるアクセス用のJSON出力が含まれています。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/elinsky/execution-system-mcp.git
cd execution-system-mcp

# 依存関係をインストールする
pip install -e ".[dev]"

📚 ドキュメント

~/.config/execution-system-mcp/config.jsonに設定ファイルを作成します。

{
  "execution_system_repo_path": "/absolute/path/to/your/execution-system-repo",
  "areas": [
    {"name": "Health", "kebab": "health"},
    {"name": "Learning", "kebab": "learning"},
    {"name": "Career", "kebab": "career"},
    {"name": "Mission", "kebab": "mission"},
    {"name": "Personal Growth Systems", "kebab": "personal-growth-systems"},
    {"name": "Social Relationships", "kebab": "social-relationships"},
    {"name": "Romance", "kebab": "romance"},
    {"name": "Emotional Health", "kebab": "emotional-health"},
    {"name": "Finance", "kebab": "finance"},
    {"name": "Character and Values", "kebab": "character-and-values"},
    {"name": "Hobbies and Recreation", "kebab": "hobbies-and-recreation"}
  ]
}

🔧 開発

# テストを実行する
pytest

# カバレッジ付きでテストを実行する
pytest --cov=src --cov-report=html

# 特定のテストファイルを実行する
pytest tests/unit/test_config.py

💻 使用例

基本的な使用法

MCPサーバーはClaude Desktopと統合されています。設定が完了すると、Claudeに問い合わせることで実行システムを管理できます。

0k - アクションの例

• "Add action 'Buy groceries' to @errands context for project meal-planning"
• "Add 'Wait for package delivery' to @waiting with defer date 2025-11-15"
• "Complete the action on line 7 of contexts/@macbook.md"
• "List all actions for the ml-refresh project"

10k - プロジェクトの例

• "Create a new project titled 'Learn Python' in the Learning area as a standard project in active folder"
• "List all active projects in the Health area"
• "Complete the project 'Learn Python'"
• "Search for projects about machine learning"

20k - エリアの例

• "List all my areas of focus"

30k - 目標の例

• "List all active goals"
• "Show me goals in the incubator"

Claudeは適切なMCPツールを使用して、実行システムとやり取りします。

利用可能なツール

0k - アクションツール

• add_action - プロジェクト検証付きでコンテキストファイルに次のアクションを追加する
• add_to_waiting - @waitingリストに項目を追加する
• add_to_deferred - @deferredリストに項目を追加する
• add_to_incubating - @incubatingリストに項目を追加する
• complete_action - 行番号でアクションを完了する
• list_actions - 柔軟なフィルタリングとグループ化でアクションを一覧表示する
• search_actions - フィルター付きでテキストでアクションを検索する

10k - プロジェクトツール

• create_project - YAMLフロントマターとテンプレートで新しいプロジェクトを作成する
• list_active_projects - エリアでグループ化してすべてのアクティブなプロジェクトを一覧表示する
• list_projects - 柔軟なフィルタリング（フォルダ、エリア、期限）でプロジェクトを一覧表示する
• complete_project - 未完了のアクションを検証してプロジェクトを完了する
• activate_project - インキュベーターからアクティブにプロジェクトを移動する
• move_project_to_incubator - アクティブからインキュベーターにプロジェクトを移動する
• descope_project - スコープ縮小フォルダにプロジェクトを移動する
• update_project_due_date - プロジェクトの期限を追加または削除する
• update_project_area - プロジェクトの焦点エリアを変更する
• update_project_type - プロジェクトのタイプ（標準/調整/習慣）を変更する
• update_review_dates - 最後のレビュー日を一括更新する
• search_projects - フィルター付きでテキストでプロジェクトを検索する

20k - エリアツール

• list_areas - すべての設定された焦点エリアを一覧表示する

30k - 目標ツール

• list_goals - アクティブとインキュベーターフォルダから目標を一覧表示する

監査とヘルスチェックツール

• audit_projects - プロジェクトのデータ品質を検証する
• audit_orphan_projects - アクションのないプロジェクトを見つける
• audit_orphan_actions - 無効なプロジェクト/コンテキストを持つアクションを見つける
• audit_action_files - アクションファイルのデータ品質を検証する
• list_projects_needing_review - 最近レビューされていないプロジェクトを見つける
• list_actions_needing_review - 最近レビューされていないアクションファイルを見つける

プロジェクト構造

execution-system-mcp/
├── src/
│   └── execution_system_mcp/
│       ├── __init__.py
│       ├── server.py          # すべてのツールハンドラーを持つMCPサーバー
│       ├── config.py          # 設定マネージャー
│       ├── creator.py         # プロジェクト作成
│       ├── lister.py          # プロジェクト一覧表示
│       ├── completer.py       # プロジェクト完了
│       ├── validator.py       # 検証ロジック
│       ├── templates.py       # プロジェクトテンプレート
│       ├── project_manager.py # プロジェクトライフサイクル管理
│       ├── action_manager.py  # アクション作成と完了
│       ├── action_lister.py   # アクション一覧表示
│       ├── goal_lister.py     # 目標一覧表示
│       ├── area_lister.py     # エリア一覧表示
│       ├── searcher.py        # 検索機能
│       └── auditor.py         # データ品質監査
├── tests/
│   └── unit/                  # 185の包括的な単体テスト
├── pyproject.toml
└── README.md

📄 ライセンス

MIT