Mission Control MCP

🚀 任务控制MCP服务器

Mission Control MCP是一个与领域无关的任务自动化和验证系统，专为Claude Code设计，具备自我验证能力，可实现任务的自主执行。

🚀 快速开始

Mission Control是专门为Claude Code设计的模型上下文协议（MCP）服务器。它提供了一个带有内置验证循环的任务自动化框架，使Claude能够：

• 自主执行任务
• 根据客观标准验证结果
• 迭代执行直至成功或达到最大尝试次数
• 为每次尝试提供详细反馈

✨ 主要特性

• ✅ 零外部依赖：所有验证均在本地运行
• 🔒 注重隐私：数据不会离开你的机器
• ⚡ 快速：验证无需网络延迟
• 🎯 与领域无关：适用于软件开发、DevOps、数据科学等多个领域
• 📊 自我验证：自动检测成功或失败
• 🔄 迭代执行：根据反馈自动重试

🏗️ 架构

核心组件

1. 任务定义器：锁定任务参数和验证标准
2. 尝试计数器：通过可配置的限制防止无限循环
3. 动态反馈引擎：生成可操作的改进建议
4. 验证策略：NUMERIC、EXIT_CODE和KEYWORD验证器
5. 状态管理器：跟踪任务进度和历史记录

工作流程

┌─────────────────────────────────────────┐
│ 1. 定义任务                             │
│    - 目标描述                           │
│    - 验证策略                           │
│    - 成功标准                           │
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 2. 执行循环                             │
│    ┌─────────────────────────────────┐  │
│    │ Claude执行任务                  │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│    ┌─────────────────────────────────┐  │
│    │ 提交尝试进行验证                 │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│    ┌─────────────────────────────────┐  │
│    │ 系统验证结果                     │  │
│    └─────────────────────────────────┘  │
│              ↓                          │
│        通过? ─否→  根据反馈重试         │
│          │                              │
│         是                             │
└─────────────────────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│ 3. 任务完成                             │
│    - 成功报告                           │
│    - 尝试历史记录                       │
└─────────────────────────────────────────┘

📦 安装指南

前提条件

• 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": ["<安装路径>/mission-control-mcp/dist/index.js"],
      "env": {
        "MCP_STATE_DIR": "<安装路径>/mission-control-mcp/.state",
        "MCP_ENABLE_PERSISTENCE": "true"
      }
    }
  }
}

验证安装

claude mcp list
# 列表中应显示mission-control，状态为✓ 已连接

💻 使用示例

验证策略

1. NUMERIC - 数值比较

适用于具有可测量数值目标的任务（性能指标、覆盖率、分数等）。 示例：测试覆盖率

// 定义任务
{
  "goal": "将测试覆盖率提高到80%",
  "strategy": "NUMERIC",
  "criteria": {
    "operator": ">=",
    "threshold": 80.0,
    "metricName": "coverage_percentage"
  },
  "maxAttempts": 10
}

// 提交尝试
{
  "missionId": "<任务ID>",
  "output": "覆盖率: 82.5%",
  "value": 82.5
}

运算符：>, <, >=, <=, ==, !=

2. EXIT_CODE - 命令状态

适用于通过命令执行成功进行验证的任务。 示例：代码检查

// 定义任务
{
  "goal": "修复所有ESLint错误",
  "strategy": "EXIT_CODE",
  "criteria": {
    "expectedCode": 0,
    "command": "npm run lint"
  },
  "maxAttempts": 8
}

// 提交尝试
{
  "missionId": "<任务ID>",
  "output": "代码检查完成",
  "value": 0  // 退出代码
}

3. KEYWORD - 文本匹配

适用于通过输出内容进行验证的任务。 示例：构建成功

// 定义任务
{
  "goal": "成功进行生产构建",
  "strategy": "KEYWORD",
  "criteria": {
    "keyword": "Build completed successfully",
    "mustContain": true,
    "caseSensitive": false
  }
}

// 提交尝试
{
  "missionId": "<任务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 "修复所有ESLint错误。使用define_mission和EXIT_CODE策略，然后迭代直到npm run lint返回0。"

Claude将：

1. 使用EXIT_CODE标准调用define_mission（expectedCode: 0）
2. 分析代码并修复错误
3. 运行npm run lint
4. 使用退出代码调用submit_attempt
5. 重复执行直到成功或达到最大尝试次数

示例2：优化性能

$ claude "将API响应时间降低到100ms以下。使用本地基准测试进行验证。"

Claude将：

1. 使用NUMERIC策略定义任务（< 100）
2. 进行优化
3. 运行基准测试
4. 提交结果
5. 根据反馈进行迭代

示例3：文档合规性

$ claude "确保所有公共函数都有JSDoc注释。使用自定义验证器进行检查。"

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许可证。

📚 参考资料

• 模型上下文协议 - MCP规范
• Claude Code MCP - Claude Code MCP文档