Execution System MCP

🚀 執行系統MCP服務器

這是一個由Claude和模型上下文協議（Model Context Protocol）驅動的AI原生執行系統，它能有效消除傳統生產力工具在使用過程中的摩擦，讓你在工作時保持流暢，同時維護一個嚴謹的執行系統。

🚀 快速開始

本執行系統MCP服務器集成了Claude Desktop，配置完成後，你可以通過向Claude提問來管理執行系統。

✨ 主要特性

服務器通過模型上下文協議實現了焦點層次模型：

0k - 下一步行動（基礎層面）

• 添加行動：將行動添加到上下文文件（如@macbook、@phone、@errands）中，並自動驗證項目。
• 添加到特殊列表：可添加到@waiting（等待他人）、@deferred（特定未來日期）、@incubating（有朝一日/可能）等特殊列表。
• 完成行動：通過行號完成行動，並自動存檔到completed.md文件。
• 列出行動：可根據上下文、項目和狀態進行靈活過濾列出行動。
• 搜索行動：通過文本搜索行動，並支持狀態和上下文過濾。
• 完全支持todo.txt格式，包含創建日期、上下文、項目、截止/延期日期。

10k - 項目（當前計劃）

• 創建項目：使用YAML前置元數據和三種模板（標準、協調、習慣）創建項目。
• 列出項目：可根據領域、截止日期等進行靈活過濾和分組列出項目。
• 搜索項目：通過標題或內容中的文本搜索項目。
• 完成項目：完成項目時會驗證所有行動是否已完成。
• 管理生命週期：可從孵化區激活項目、將項目移回孵化區或縮小範圍。
• 更新元數據：支持更新截止日期、領域、類型、審查日期等（支持批量更新）。
• 審計工具：驗證數據質量、查找孤立項目/行動、識別需要審查的項目。

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許可證。