Mission Control MCP

🚀 Mission Control MCP Server

Mission Control MCPは、Claude Code用のドメインに依存しないタスク自動化と検証システムです。自己検証機能を備えた自律的なタスク実行を可能にします。

🚀 クイックスタート

Mission Control MCP Serverは、Claude Code用に設計されたModel Context Protocol (MCP) サーバーです。このサーバーを使用することで、タスクの自動化と検証を行うことができます。以下に、基本的な使い方を説明します。

✨ 主な機能

• ✅ 外部依存なし：すべての検証はローカルで実行されます。
• 🔒 プライバシー重視：データはマシン内に留まり、外部に送信されません。
• ⚡ 高速：検証にネットワーク遅延が発生しません。
• 🎯 ドメイン非依存：ソフトウェア開発、DevOps、データサイエンスなど、様々なドメインで動作します。
• 📊 自己検証：自動的に成功または失敗を検出します。
• 🔄 反復処理：フィードバックを伴う自動リトライが可能です。

🏗️ アーキテクチャ

コアコンポーネント

1. Mission Definer：タスクパラメータと検証基準を設定します。
2. Attempt Counter：設定可能な制限により、無限ループを防止します。
3. Dynamic Feedback Engine：実行可能な改善提案を生成します。
4. Validation Strategies：NUMERIC、EXIT_CODE、およびKEYWORDの検証機能を提供します。
5. State Manager：タスクの進行状況と履歴を追跡します。

ワークフロー

┌─────────────────────────────────────────┐
│ 1. Define Mission                       │
│    - Goal description                   │
│    - Validation strategy                │
│    - Success criteria                   │
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 2. Execution Loop                       │
│    ┌─────────────────────────────────┐  │
│    │ Claude executes task            │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│    ┌─────────────────────────────────┐  │
│    │ Submit attempt for validation   │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│    ┌─────────────────────────────────┐  │
│    │ System validates result         │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│        Pass? ─No→ Retry with feedback   │
│          │                              │
│         Yes                             │
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 3. Mission Complete                     │
│    - Success report                     │
│    - Attempt history                    │
└─────────────────────────────────────────┘

📦 インストール

前提条件

• Node.js >= 18.0.0
• npm または yarn
• Claude Code CLI

オプション1: NPMによるインストール (推奨)

npmを使ってグローバルにインストールします。

npm install -g mission-control-mcp

次に、Claude Codeに追加します。

claude mcp add mission-control mission-control-mcp

または、手動で設定することもできます。

設定ファイルの場所:

• macOS/Linux: ~/.config/claude-code/mcp.json
• Windows: %USERPROFILE%\.claude-code\mcp.json

{
  "mcpServers": {
    "mission-control": {
      "command": "mission-control-mcp",
      "env": {
        "MCP_ENABLE_PERSISTENCE": "true"
      }
    }
  }
}

オプション2: npxを使用する (インストール不要)

claude mcp add mission-control --transport stdio -- npx -y mission-control-mcp

オプション3: ソースからのインストール (開発用)

# リポジトリをクローンする
git clone https://github.com/ufo23005/mission-control-mcp.git
cd mission-control-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

Claude Codeを設定します。

設定ファイルの場所:

• macOS/Linux: ~/.config/claude-code/mcp.json
• Windows: %USERPROFILE%\.claude-code\mcp.json

{
  "mcpServers": {
    "mission-control": {
      "command": "node",
      "args": ["<path-to-installation>/mission-control-mcp/dist/index.js"],
      "env": {
        "MCP_STATE_DIR": "<path-to-installation>/mission-control-mcp/.state",
        "MCP_ENABLE_PERSISTENCE": "true"
      }
    }
  }
}

インストールの確認

claude mcp list
# リストにmission-controlが表示され、✓ Connectedのステータスが表示されるはずです。

💻 使用例

検証戦略

1. NUMERIC - 数値比較

測定可能な数値目標 (パフォーマンス指標、カバレッジ、スコアなど) を持つタスクに使用します。

例: テストカバレッジ

// ミッションを定義する
{
  "goal": "Increase test coverage to 80%",
  "strategy": "NUMERIC",
  "criteria": {
    "operator": ">=",
    "threshold": 80.0,
    "metricName": "coverage_percentage"
  },
  "maxAttempts": 10
}

// 試行を送信する
{
  "missionId": "<mission-id>",
  "output": "Coverage: 82.5%",
  "value": 82.5
}

演算子: >, <, >=, <=, ==, !=

2. EXIT_CODE - コマンドステータス

コマンドの実行成功によって検証されるタスクに使用します。

例: リンティング

// ミッションを定義する
{
  "goal": "Fix all ESLint errors",
  "strategy": "EXIT_CODE",
  "criteria": {
    "expectedCode": 0,
    "command": "npm run lint"
  },
  "maxAttempts": 8
}

// 試行を送信する
{
  "missionId": "<mission-id>",
  "output": "Linting complete",
  "value": 0  // exit code
}

3. KEYWORD - テキストマッチング

出力内容によって検証されるタスクに使用します。

例: ビルド成功

// ミッションを定義する
{
  "goal": "Successful production build",
  "strategy": "KEYWORD",
  "criteria": {
    "keyword": "Build completed successfully",
    "mustContain": true,
    "caseSensitive": false
  }
}

// 試行を送信する
{
  "missionId": "<mission-id>",
  "output": "Build completed successfully. Output: dist/"
}

🛠️ MCPツール

define_mission

検証基準を持つ新しい自動化タスクを定義します。

パラメータ:

• goal (文字列): 自然言語でのタスク説明
• strategy (列挙型): NUMERIC | EXIT_CODE | KEYWORD
• criteria (オブジェクト): 戦略固有の検証パラメータ
• maxAttempts (数値, オプション): 最大リトライ回数 (デフォルト: 10)
• enableCheckpoints (ブール値, オプション): 回復チェックポイントを有効にする
• checkpointFrequency (数値, オプション): チェックポイントをN回の試行ごとに作成する

戻り値: ミッションIDと設定

submit_attempt

タスクの実行結果を検証のために送信します。

パラメータ:

• missionId (文字列): ミッション識別子
• output (文字列): コマンド/プロセスの出力
• value (数値|文字列, オプション): 抽出された検証値

戻り値: フィードバックと次の手順を含む検証結果

get_mission_status

現在のミッションの進行状況と履歴を照会します。

パラメータ:

• missionId (文字列): ミッション識別子

戻り値: ステータス、試行回数、および履歴

abort_mission

実行中のミッションを手動で停止します。

パラメータ:

• missionId (文字列): ミッション識別子
• reason (文字列, オプション): 中止理由

戻り値: 確認と最終ステータス

📖 具体例

例1: ESLintエラーを修正する

$ claude "Fix all ESLint errors. Use define_mission with EXIT_CODE strategy, then iterate until npm run lint returns 0."

Claudeは以下の手順を実行します。

1. EXIT_CODE基準 (expectedCode: 0) で define_mission を呼び出す
2. コードを分析し、エラーを修正する
3. npm run lint を実行する
4. 終了コードを指定して submit_attempt を呼び出す
5. 成功するか最大試行回数に達するまで繰り返す

例2: パフォーマンスを最適化する

$ claude "Reduce API response time below 100ms. Validate with local benchmark tests."

Claudeは以下の手順を実行します。

1. NUMERIC戦略 (< 100) でミッションを定義する
2. 最適化を行う
3. ベンチマークテストを実行する
4. 結果を送信する
5. フィードバックに基づいて反復する

例3: ドキュメントの遵守

$ claude "Ensure all public functions have JSDoc comments. Check with custom validator."

Claudeは以下の手順を実行します。

1. KEYWORDまたはカスタム検証でミッションを定義する
2. 欠落しているドキュメントを追加する
3. ドキュメントチェッカーを実行する
4. 完全性を検証する

🔧 設定

状態管理

オーケストレータは .state/ ディレクトリに状態を保持します。

.state/
├── missions/       # アクティブおよび完了したミッション
└── checkpoints/    # 回復チェックポイント

保持ポリシー

• 完了したミッション: 30日 (設定可能)
• 失敗したミッション: 90日 (分析用)
• アクティブなミッション: 完了するまで保持されます

リソース制限

デフォルトの制限 (コード内で設定可能):

• 最大試行回数: 10
• チェックポイント頻度: 5回の試行ごと
• 試行タイムアウト: なし (ミッションごとに設定可能)

📁 プロジェクト構造

src/
├── index.ts              # MCPサーバーのエントリポイント
├── types/                # TypeScriptの型定義
│   ├── mission.ts        # ミッションと試行の型
│   ├── validation.ts     # 検証戦略の型
│   └── state.ts          # 状態管理の型
├── core/                 # コアコンポーネント
│   ├── MissionDefiner.ts # ミッションの設定
│   ├── AttemptCounter.ts # リトライ管理
│   └── FeedbackEngine.ts # フィードバック生成
├── validators/           # 検証戦略
│   ├── BaseValidator.ts
│   ├── NumericValidator.ts
│   ├── ExitCodeValidator.ts
│   └── KeywordValidator.ts
├── state/                # 状態管理
│   └── StateManager.ts   # ミッションの状態追跡
├── tools/                # MCPツールの実装
│   ├── defineMission.ts
│   ├── submitAttempt.ts
│   ├── getMissionStatus.ts
│   └── abortMission.ts
└── utils/                # ユーティリティ
    ├── logger.ts         # ロギングシステム
    └── errors.ts         # エラータイプ

🎯 ユースケース

🔒 プライバシーとセキュリティ

• 外部APIを使用しない：すべての検証はローカルで実行されます。
• データを送信しない：すべてのデータはマシン内に留まります。
• ネットワーク不要：完全にオフラインで動作します。
• 監査ログ：完全な試行履歴が記録されます。
• 設定可能な制限：リソースの枯渇を防止します。

🚧 制限事項

適しているケース:

• 客観的に測定可能な結果
• 繰り返し可能な操作
• 自動化可能な検証
• ローカルコマンドラインツール

適していないケース:

• 主観的な品質判断
• 一度だけの不可逆的な操作
• 人間の創造性を必要とするタスク
• リアルタイムの対話型プロセス

🤝 コントリビューション

コントリビューションを歓迎します！以下の点を確認してください。

• すべてのTypeScript型が定義されていること
• コードが既存のパターンに従っていること
• テストが通過すること (実装されている場合)
• ドキュメントが更新されていること

📄 ライセンス

MIT

📚 参考文献

• Model Context Protocol - MCP仕様
• Claude Code MCP - Claude Code MCPのドキュメント