SystemPrompt Coding Agent

## ⚠️ 已弃用--不再维护 此存储库已被取代。所有新的开发和支持都存在于： - systempromptio/systemprompt模板 --从这里开始。对完整的systemprompt.io人工智能治理基础设施进行自托管评估。 - systempromptio/systemprompt核心 --底层Rust库（MCP、A2A、OAuth 2.1、审计、编译时扩展）。 了解更多 系统提示.io. _下面保留了原始的README以供历史参考。_

______________________________________________________________________

🚀 SystemPrompt编码代理

将您的工作站变成可远程访问的AI编码助手

  

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

______________________________________________________________________

💯 100%免费开源

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

⭐ 星 此回购•📢 分享 与您的网络🐛 报告问题 • 🤝 贡献 代码

*每一个明星、分享和贡献都帮助我们为社区改进这个工具！*

______________________________________________________________________

📱 适用于任何MCP客户端

此服务器是100%免费和开源的 并与任何兼容MCP的客户端配合使用。

我们还提供 付费订阅 本机移动应用程序（SystemPrompt），专为与此服务器进行语音优先交互而设计。\ 移动应用程序仍处于早期开发阶段，但提供了一种本地移动体验，可以从任何地方控制你的编码代理。

______________________________________________________________________

📋 快速导航

入门指南: 快速开始 | 安全 | 远程访问\ 文档: 建筑 | 工具 | 模板\ 特性: 隧道入口 | 推送通知 | 状态持久性

这是什么？

这就是 SystemPrompt编码代理 -一个尖端项目，将您的工作站转换为任何MCP客户端都可以连接到的远程可访问的MCP（模型上下文协议）服务器。它是 SystemPrompt.io 该生态系统为开发人员开创了原生移动语音控制AI编排的先河。

关于SystemPrompt.io

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

• 自筹资金和独立 -由一位创始人与社区共同打造
• 快速迭代 -“直观、原始、尖端的软件”正在迅速发展
• 移动优先 -用于语音控制开发的原生iOS和Android应用程序
• 舞台透明 -早期但功能齐全，“就像有一个非常渴望但有点困惑的机器人”

此编码代理的工作原理

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

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

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

为什么存在

SystemPrompt移动应用程序用户一直在问“但我该怎么办？”答案是： 远程管理您自己的开发环境和代理。在MCP服务器采用曲线的这个阶段，这个编码代理是杀手级用例，它使开发人员能够只使用语音从任何地方进行编码。

快速入门\[需要Claude代码、Docker\]

# Clone and setup
git clone https://github.com/systempromptio/systemprompt-code-orchestrator
cd systemprompt-code-orchestrator

# Install and run
npm i 
npm run setup
npm run start

# Test with the inspector
npm run inspector

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

先决条件

安装脚本将自动检查这些：

• Node.js 18+（必填）
• Docker和Docker Compose（必填）
• Claude Code CLI（可选但推荐-安装脚本将指导您）

基本命令

npm run start    # Start all services (daemon + Docker)
npm run stop     # Stop all services gracefully
npm run status   # Check service health
npm run logs     # View real-time logs
npm run tunnel   # Start with internet tunnel (requires Cloudflare)

基本配置

# Required (setup will prompt for this)
PROJECT_ROOT=/path/to/your/code  # ⚠️ AI agents have FULL access here

# Optional (with defaults)
PORT=3000
COMPOSE_PROJECT_NAME=systemprompt-coding-agent

# Optional (for additional features)
CLOUDFLARE_TOKEN=your_token  # For tunnel access
PUSH_TOKEN=your_token        # For mobile notifications

技术架构

MCP Client (Mobile/Desktop)
    |
    v
Docker Container (MCP Server)
    - Handles MCP protocol
    - Resource subscriptions
    - Event streaming
    |
    v
Host Bridge Daemon (TCP Socket)
    - Command routing
    |
    v
Host Machine
    - AI agent execution
    - File system access

关键技术创新

1.实时资源订阅模型

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

// Client subscribes to task resources, notified by listChanged notifications
client.listResources()
client.getResource({ uri: "task://abc-123" })

// When task updates, server automatically:
// 1. Saves task to disk (JSON persistence)
await this.persistence.saveTask(updatedTask);

// 2. Emits internal event
this.emit("task:updated", updatedTask);

// 3. Sends MCP notification to subscribed clients
await sendResourcesUpdatedNotification(`task://${taskId}`, sessionId);
// This triggers: { method: "notifications/resources/updated", params: { uri: "task://abc-123" } }

// Client receives notification and can re-fetch the updated resource

这实现了无需轮询的实时任务监控——客户端在任务状态更改发生时保持同步。

2.推送任务完成通知

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

// Task completes → Push notification sent
{
  notification: {
    title: "Task Complete",
    body: "Your refactoring task finished successfully"
  },
  data: {
    taskId: "abc-123",
    status: "completed",
    duration: "45s"
  }
}

非常适合长时间运行的任务——开始一项任务，开始你的一天，完成后收到通知。

3.有状态的过程管理

• 任务以JSON格式通过原子写入持久化到磁盘
• 在守护进程重启期间维护的进程会话
• 任务生命周期的综合状态机：

  pending → in_progress → waiting → completed
                      ↓
                    failed

事件驱动架构

所有操作都会发出多个子系统消耗的事件：

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

远程访问选项

🌐 通过Cloudflare隧道访问互联网

更复杂的选项，如打开Cloudflare隧道向本地计算机公开HTTPS URL，都有记录，但默认情况下不包括在内（风险自负）。

npm run tunnel

这将：

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

→ 完整隧道文件

🏠 本地网络接入

如果您希望将所有内容都保留在本地网络上：

1. 正常启动服务器：

   npm start

1. 从同一网络上的设备访问：

- 查找您计算机的IP地址 - 使用以下方式连接： http://YOUR_IP:3000/mcp

核心功能

🤖 AI代理编排

• 多代理支持：Claude Code CLI开箱即用，可扩展到任何代理
• 任务管理：创建、跟踪和管理编码任务- 任务管理→
• 会话隔离：每个任务都在自己的上下文中运行- 克劳德集成→
• 实时流媒体：观看AI代理实时工作- 事件系统→

📱 移动优先设计

• 语音命令：“创建带有验证的登录表单”
• 推送通知：任务完成时收到警报- 推送通知→
• 快捷操作：常见任务的预定义模板- 提示模板→
• 遥控器：随时随地管理您的开发环境

🔧 MCP协议特性

• 持久状态：任务在服务器重启后仍然存在- 状态持久性→
• 资源管理：将任务数据作为MCP资源公开- 工具和资源→
• 互动提示：人工智能代理可以要求澄清
• 进度通知：实时状态更新
• 结构化数据：完整架构验证- MCP服务器→

工具参考

→ 完整的工具和资源文档

任务编排

系统管理

预构建提示

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

🐛 漏洞修复

{
  "prompt_template": "bug_fix",
  "variables": {
    "bug_description": "Login fails after password reset",
    "error_logs": "401 Unauthorized at auth.js:42"
  }
}

⚛️ React组件

{
  "prompt_template": "react_component",
  "variables": {
    "component_name": "UserDashboard",
    "features": ["data visualization", "real-time updates", "export functionality"]
  }
}

🧪 单元测试

{
  "prompt_template": "unit_test",
  "variables": {
    "target_files": ["src/auth/*.js"],
    "framework": "jest",
    "coverage_target": 85
  }
}

📚 综合文档

核心架构

• 守护进程 -执行命令和管理Claude进程的主机端网桥
• **** -Docker容器和主机如何交互
• MCP服务器 -模型上下文协议服务器实现

AI代理系统

• 代理经理 -所有AI代理会话的中央编排器
• Claude代码集成 -如何集成和管理Claude Code CLI
• 任务管理 -任务生命周期、持久性和状态管理

协议和API

• 工具与资源 -MCP工具和资源实施
• 事件系统和日志记录 -实时事件流和结构化日志记录

附加功能

• 测试框架 -E2E测试设置和最佳实践
• 隧道和远程访问 -Cloudflare隧道设置用于互联网接入
• 状态持久性 -任务和会话在重新启动后如何持续
• 推送通知 -移动推送通知集成
• 提示模板 -预置常见任务提示系统

性能优化

1. 流输出：代理输出以块的形式流式传输，不缓冲
2. 延迟资源加载：按需获取的资源
3. 连接池：重用到守护进程的TCP连接
4. 高效的状态持久性：仅更改了写入磁盘的字段

发展

项目结构

systemprompt-coding-agent/
├── src/
│   ├── server.ts           # MCP server setup
│   ├── handlers/           # Protocol handlers
│   ├── services/           # Agent services
│   ├── constants/          # Tool definitions
│   └── types/              # TypeScript types
├── docker-compose.yml
└── package.json

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

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

支持

• 文档: docs.systemprompt.io
• GitHub 问题: 报告错误
• Discord 的中文翻译是“不和谐”或“纷争”。: 加入我们的社区
• 推特: @系鞋带\_

未来路线图

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

MCP客户端选项

虽然此服务器可与任何兼容MCP的客户端配合使用，但要获得移动语音控制体验，请查看 SystemPrompt.io -虽然还很早，但它是一款专为语音驱动的AI编码工作流程设计的原生iOS/Android应用程序。我们希望创建这些任务，并通过我们的语音与它们异步交互！

许可证

MIT许可证-请参阅 许可证

______________________________________________________________________

Built with love by SystemPrompt.io

AI-Powered Development from Anywhere