Apogee AI开发SDK
用于同时进行克劳德代码+GPT-5开发的官方MCP服务器
Apogee通过明确的角色分离、写围栏协调以及Claude（计划者+数据库所有者）和GPT-5（实现者）之间的实时同步，实现了协同人工智能开发。
🚀 快速开始
安装
npm install -g @apogee/mcp-server用于光标（GPT-5执行器）
添加到您的 .cursor/mcp.json:
{
"mcpServers": {
"apogee": {
"command": "npx",
"args": ["-y", "@apogee/mcp-server", "--stdio"],
"env": {
"APOGEE_ROLE": "implementer"
}
}
}
}Claude Code（规划师）
将Apogee添加为远程MCP服务器：
- 网址：
https://api.apogee.dev/mcp - Auth：带有承载令牌
role:planner范围
对于Claude消息API
{
"model": "claude-sonnet-4-20250514",
"messages": [...],
"mcp_servers": [{
"type": "url",
"url": "https://api.apogee.dev/mcp",
"name": "apogee",
"authorization_token": "Bearer YOUR_PLANNER_JWT"
}]
}🏗️ 建筑
角色分离
Claude Code（规划师+数据库所有者）
- ✅ 数据库模式设计
- ✅ Supabase SQL迁移
- ✅ 数据访问策略
- ✅ 高层规划
- ❌ 应用程序代码实现
光标代理（GPT-5执行器）
- ✅ API路线和服务
- ✅ 用户界面组件
- ✅ 测试和脚本
- ✅ 代码重构
- ❌ 数据库迁移
写围栏系统
一次只能有一个代理应用文件修补程序：
- 围栏开始于
implementer - 通过以下方式切换
apogee.fence.set({ owner: "planner" | "implementer" }) - 防止同步开发过程中的文件冲突
🛠️ 可用工具
待办事项管理
apogee.todo.update({
"diff": [{
"operation": "create",
"desc": "Implement user authentication API",
"assignee": "implementer",
"status": "pending"
}]
})写入围栏控制
apogee.fence.set({
"owner": "planner" // or "implementer"
})补丁应用程序
apogee.patch.apply({
"diff": "--- a/src/api.ts\n+++ b/src/api.ts\n...",
"rationale": "Add user endpoint with validation"
})数据库迁移（仅限Claude）
apogee.db.migrate({
"planId": "create_users_table",
"dryRun": false
})沟通
apogee.comms.post({
"text": "Migration completed, implementer can now build the API",
"tags": ["handoff", "db-ready"]
})📊 资源
通过MCP资源访问实时状态：
log://comms-实时通信馈送todos://board-当前任务分配schema://current-实时数据库架构ci://latest-构建和测试状态
🔧 地方发展
# Clone and install
git clone https://github.com/apogee-studios/ai-dev-sdk
cd apogee
npm install
# Start in stdio mode (for Cursor)
npm run dev --workspace=apps/mcp-server -- --stdio
# Start HTTP server (for remote MCP)
npm run dev --workspace=apps/mcp-server -- --port=3001
# Generate JWT tokens for testing
node -e "
const jwt = require('jsonwebtoken');
console.log('Planner:', jwt.sign({role:'planner', sessionId:'test'}, 'dev-secret'));
console.log('Implementer:', jwt.sign({role:'implementer', sessionId:'test'}, 'dev-secret'));
"🚢 部署
码头工人
docker build -f infra/docker/Dockerfile -t apogee/mcp-server .
docker run -p 3001:3001 -e JWT_SECRET=your-secret apogee/mcp-serverKubernetes
kubectl apply -f infra/k8s/环境变量
JWT_SECRET-JWT签名秘密REDIS_URL-Redis连接（可选，在内存中使用）NODE_ENV-生产/开发
🔒 安全
认证
- HTTP模式：具有基于角色的作用域的JWT承载令牌
- 标准模式：基于环境的角色分配
- 原产地验证：限制为允许的域
授权矩阵
| 工具 | 规划师（Claude） | 实施者（GPT-5） |
|---|---|---|
apogee.todo.* | ✅ | ✅ |
apogee.fence.* | ✅ | ✅ |
apogee.patch.apply | ✅ （当围栏所有者时） | ✅ （围栏所有者时） |
apogee.db.migrate | ✅ | ❌ |
apogee.comms.* | ✅ | ✅ |
📖 协议合同
两个代理都必须遵循以下输出格式：
Short natural response explaining the action.
HANDOFF::planner (or HANDOFF::implementer)
DONE (if task complete)
TODOS_JSON [{"id":"...", "desc":"...", "assignee":"...", "status":"..."}]
FILE_PATCH (unified diff when applying changes)
OBSERVE: Brief note about the other agent's last action🔗 集成示例
克劳德代码系统提示
You are CLAUDE (Planner & Database Owner). You always own:
- Database schema, Supabase SQL migrations/seeds/policies
- High-level planning and code review
Use apogee.db.migrate for all database changes.
Use HANDOFF::implementer when ready for code implementation.光标代理系统提示
You are GPT (Implementer). You always own:
- Application code (API routes, UI, services, business logic)
- Tests, scripts, and refactors
Never run database migrations - request them from the planner.
Use HANDOFF::planner when database changes are needed.🤝 贡献
- 分叉存储库
- 创建要素分支
- 添加新功能的测试
- 确保所有测试通过：
npm test - 提交拉取请求
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件。
______________________________________________________________________
准备好实现人工智能的合作开发了吗？
开始： npm install -g @apogee/mcp-server