系统提示代码编排器

Name: 系统提示代码编排器
Author: systempromptio

作者：systempromptio123 星标更新：2025-07-03

安装使用来源：spider==github.com

项目介绍

🚀 SystemPrompt 编码代理

将您的工作站转变为可远程访问的人工智能编码助手

官方网站 • 文档 • 观看演示视频

</div>

💯 100% 免费且开源

我们感谢您的支持！ 如果您发现这个项目有用，请考虑：

⭐ 给这个仓库加星 • 📢 分享给您的网络 • 🐛 报告问题 • 🤝 贡献代码

每个星标、分享和贡献都帮助我们改进这个工具以服务于社区！

</div>

📱 适用于任何MCP客户端

此服务器是100%免费且开源的，并可以与任何兼容MCP的客户端一起工作。

我们还提供一个付费订阅的原生移动应用（SystemPrompt），旨在实现与该服务器的第一语音交互。移动应用程序仍处于早期开发阶段，但提供了从任何地方控制您的编码代理的原生移动体验。

📋 快速导航

这是什么？

这是 SystemPrompt 编码代理 —— 一个前沿项目，它将您的工作站转换成一个任何MCP（模型上下文协议）客户端都可以连接的远程可访问的MCP服务器。它是 SystemPrompt.io 生态系统的一部分，该生态系统正在为开发者开创原生移动语音控制的人工智能编排。

关于SystemPrompt.io

SystemPrompt 是一个实验性的、由社区驱动的项目（目前处于v0.01版本），它使开发者能够通过自然语言语音命令与人工智能互动并执行复杂的流程。该项目：

自筹资金且独立 —— 由单个创始人与社区共同构建
快速迭代 —— “粘稠、原始、尖端软件” 正在迅速发展
移动优先 —— 原生iOS和Android应用程序用于语音控制开发
透明地展示其阶段 —— 早期但功能齐全，“就像有一个非常渴望但有点困惑的机器人”

这个编码代理是如何工作的？

从任何地方发送编码任务，AI代理（默认为Claude，可扩展到任何其他代理）将在您的实际机器上直接执行。您的代码永远不会离开您的计算机，但您可以从任何地方通过以下方式控制它：

语音命令 通过SystemPrompt移动应用程序
任何兼容MCP的客户端
随附的检查器工具

此项目将您的本地机器暴露为一个可以通过远程控制的MCP服务器。AI代理直接在您的机器上运行，并具有对您的真实开发环境和工具的访问权限。

为什么存在这个项目？

SystemPrompt移动应用程序用户一直在问“那我用它做什么？”答案：远程管理您自己的开发环境和代理。这个编码代理是当前采用曲线中MCP服务器的杀手级用例——允许开发者仅使用他们的声音从任何地方进行编码。

快速入门 [需要Claude Code, Docker]

# 克隆并设置
git clone https://github.com/systempromptio/systemprompt-code-orchestrator
cd systemprompt-code-orchestrator

# 安装并运行
npm i 
npm run setup
npm run start

# 使用检查器测试
npm run inspector

创建的任务可以通过检查器执行，应该通过隧道连接到您的Claude Code安装，保存在Docker容器中的结构化日志（作为MCP资源公开），并通过检查器（以及任何MCP客户端）启用执行。

预备条件

设置脚本会自动检查这些内容：

Node.js 18+（必需）
Docker 和 Docker Compose（必需）
Claude Code CLI（可选但推荐 —— 设置脚本会引导您）

必要命令

npm run start    # 启动所有服务（守护进程 + Docker）
npm run stop     # 平稳停止所有服务
npm run status   # 检查服务健康状况
npm run logs     # 查看实时日志
npm run tunnel   # 开启互联网隧道（需要Cloudflare）

必要配置

# 必需（设置脚本会提示）
PROJECT_ROOT=/path/to/your/code  # ⚠️ AI代理在此处拥有完全访问权限

# 可选（带有默认值）
PORT=3000
COMPOSE_PROJECT_NAME=systemprompt-coding-agent

# 可选（用于附加功能）
CLOUDFLARE_TOKEN=your_token  # 用于隧道访问
PUSH_TOKEN=your_token        # 用于移动通知

技术架构

MCP客户端（移动/桌面）
    |
    v
Docker容器（MCP服务器）
    - 处理MCP协议
    - 资源订阅
    - 事件流
    |
    v
主机桥接守护进程（TCP套接字）
    - 命令路由
    |
    v
主机机器
    - AI代理执行
    - 文件系统访问

关键技术创新

1. 实时资源订阅模型

服务器实现了MCP SDK的listChanged模式用于资源订阅。当任务状态发生变化时：

// 客户端订阅任务资源，由listChanged通知
client.listResources()
client.getResource({ uri: "task://abc-123" })

// 当任务更新时，服务器自动：
// 1. 将任务保存到磁盘（JSON持久化）
await this.persistence.saveTask(updatedTask);

// 2. 发出内部事件
this.emit("task:updated", updatedTask);

// 3. 向已订阅的客户端发送MCP通知
await sendResourcesUpdatedNotification(`task://${taskId}`, sessionId);
// 这触发：{ method: "notifications/resources/updated", params: { uri: "task://abc-113" } }

// 客户端接收通知并可以重新获取更新的资源

这使得实时任务监控无需轮询 —— 客户端随着任务状态变化同步更新。

2. 任务完成的推送通知

集成Firebase云消息（FCM）支持，在任务完成后向移动设备发送推送通知：

// 任务完成 → 发送推送通知
{
  notification: {
    title: "任务完成",
    body: "您的重构任务成功完成"
  },
  data: {
    taskId: "abc-123",
    status: "已完成",
    duration: "45秒"
  }
}

非常适合长时间运行的任务 —— 开始一个任务，继续您的日常活动，任务完成时收到通知。

3. 有状态的过程管理

任务以JSON形式持久化到磁盘，具有原子写入
进程会话在守护进程重启之间保持

综合的任务生命周期状态机：

待处理 → 进行中 → 等待 → 完成
                    ↓
                  失败

事件驱动架构

所有操作都会发出事件，被多个子系统消费：

日志记录器：带上下文的结构化JSON日志
状态管理器：任务状态更新
通知器：向移动客户端发送推送通知
指标：性能和使用分析

远程访问选项

🌐 通过Cloudflare隧道访问互联网

更复杂的选项如打开一个Cloudflare隧道来公开一个HTTPS URL到您的本地机器已被记录，但默认情况下不包括（自行承担风险）。

npm run tunnel

这将：

创建一个到您本地服务器的安全HTTPS隧道
显示公共URL和本地网络地址
从任何地方启用访问（包括移动设备）

→ 完整隧道文档

🏠 局域网访问

如果您希望保持一切在局域网内：

正常启动服务器：
```
npm start
```
从同一网络内的设备访问：
- 找到您的机器IP地址
- 使用：http://YOUR_IP:3000/mcp连接

核心功能

🤖 AI代理编排

多代理支持：默认为Claude Code CLI，可扩展到任何代理
任务管理：创建、跟踪和管理编码任务 —— 任务管理 →
会话隔离：每个任务都在自己的上下文中运行 —— Claude集成 →
实时流式传输：实时观察AI代理的工作 —— 事件系统 →

📱 移动优先设计

语音命令：“创建一个带有验证的登录表单”
推送通知：任务完成时获得警报 —— 推送通知 →
快速操作：常见任务的预定义模板 —— 提示模板 →
远程控制：从任何地方管理您的开发环境

🔧 MCP协议功能

持久状态：任务在服务器重启后仍然存在 —— 状态持久化 →
资源管理：将任务数据作为MCP资源公开 —— 工具及资源 →
交互式提示：AI代理可以请求澄清
进度通知：实时状态更新
结构化数据：完整的模式验证 —— MCP服务器 →

工具参考

→ 完整工具和资源文档

任务编排

工具	描述	示例
`create_task`	开始新的AI编码会话	`{"title": "添加认证", "tool": "CLAUDECODE", "instructions": "..."}`
`update_task`	发送额外指令	`{"process": "session_123", "instructions": "..."}`
`end_task`	完成并清理	`{"task_id": "task_123", "status": "已完成"}`
`report_task`	生成任务报告	`{"task_ids": ["task_123"], "format": "markdown"}`

系统管理

工具	描述	示例
`check_status`	验证代理可用性	`{"test_sessions": true, "verbose": true}`
`update_stats`	获取系统统计信息	`{"include_tasks": true}`
`clean_state`	清理旧任务	`{"keep_recent": true, "dry_run": true}`

预建提示

SystemPrompt 包含强大的提示模板，用于常见的编码任务。→ 完整提示模板文档

🐛 错误修复

{
  "prompt_template": "错误修复",
  "variables": {
    "错误描述": "密码重置后登录失败",
    "错误日志": "401未经授权在auth.js:42"
  }
}

⚛️ React组件

{
  "prompt_template": "react组件",
  "variables": {
    "组件名称": "用户仪表板",
    "功能": ["数据可视化", "实时更新", "导出功能"]
  }
}

🧪 单元测试

{
  "prompt_template": "单元测试",
  "variables": {
    "目标文件": ["src/auth/*.js"],
    "框架": "jest",
    "覆盖率目标": 85
  }
}

📚 综合文档

核心架构

守护进程 —— 在主机侧的桥梁，执行命令并管理Claude进程
Docker架构 —— Docker容器和主机机器如何交互
MCP服务器 —— 模型上下文协议服务器实现

AI代理系统

代理管理器 —— 所有AI代理会话的中央协调器
Claude Code集成 —— 如何集成和管理Claude Code CLI
任务管理 —— 任务生命周期、持久性和状态管理

协议及API

工具和资源 —— MCP工具和资源实现
事件系统和日志记录 —— 实时事件流和结构化日志记录

额外功能

测试框架 —— E2E测试设置和最佳实践
隧道和远程访问 —— Cloudflare隧道设置以实现互联网访问
状态持久化 —— 任务和会话如何跨重启持久化
推送通知 —— 移动推送通知集成
提示模板 —— 用于常见任务的预建提示系统

性能优化

流式输出：代理输出分块流式传输，而不是缓冲
延迟资源加载：按需加载资源
连接池：复用到守护进程的TCP连接
高效的持久化状态：仅写入更改的字段到磁盘

开发

项目结构

systemprompt-coding-agent/
├── src/
│   ├── server.ts           # MCP服务器设置
│   ├── handlers/           # 协议处理器
│   ├── services/           # 代理服务
│   ├── constants/          # 工具定义
│   └── types/              # TypeScript类型
├── docker-compose.yml
└── package.json

贡献

分叉仓库
创建功能分支
进行您的更改
提交拉取请求

对于安全问题，请发送邮件至 security@systemprompt.io

支持

文档：docs.systemprompt.io
GitHub问题：报告错误
Discord：加入我们的社区
Twitter：@tyingshoelaces_

未来路线图

多代理编排：协调多个AI代理执行复杂任务
增量计算：缓存并复用AI输出
分布式执行：将任务分散到多台机器上
Web UI仪表板：基于浏览器的监控和控制

MCP客户端选项

虽然此服务器可以与任何兼容MCP的客户端一起工作，但为了获得移动语音控制体验，请查看 SystemPrompt.io —— 仍处于早期阶段，但是一款专门为语音驱动的AI编码工作流程设计的原生iOS/Android应用程序。我们希望异步地通过我们的声音创建这些任务并与它们互动！

许可

MIT许可 —— 详见 LICENSE

<div align="center"> <strong>由 <a href="https://systemprompt.io">SystemPrompt.io</a> 热情打造</strong><br> <em>从任何地方进行人工智能驱动的开发</em> </div>