内容
# MCP Goose Subagents 服务器
一款MCP（模型上下文协议）服务器，允许AI客户端通过Goose CLI子代理将任务委托给自主开发团队。
## 功能特点
- **委托给子代理**：为不同的开发角色创建专门的AI代理
- **并行和顺序执行**：同时或按顺序运行代理
- **配方系统**：创建可重用的代理配置
- **会话管理**：跟踪和检索活动子代理会话的结果
- **纯Goose CLI集成**：仅使用Goose CLI进行子代理委托
## 前置条件
1. **安装并配置Goose CLI**
2. **Node.js**（v18或更高版本）
3. **启用Goose子代理的Alpha功能**
## 安装
```bash
npm install
```
## 使用方法
### 1. 添加到MCP配置
将此服务器添加到您的MCP客户端配置中（例如，`mcp_config.json`）：
```json
{
"mcpServers": {
"goose-subagents": {
"command": "node",
"args": ["path/to/mcp-goose-subagents/src/index.js"],
"env": {
"ALPHA_FEATURES": "true"
}
}
}
}
```
### 2. 启用Goose Alpha功能
```bash
export ALPHA_FEATURES=true
```
## 可用工具
### `delegate_to_subagents`
将开发任务委托给专门的Goose子代理。
**参数：**
- `task`（字符串）：要委托的开发任务
- `agents`（数组）：子代理配置数组
- `role`（字符串）：代理角色（例如，“后端开发者”，“前端开发者”）
- `instructions`（字符串）：代理的具体指令
- `recipe`（字符串，可选）：要使用的配方名称
- `execution_mode`（字符串）：“parallel”或“sequential”
- `working_directory`（字符串，可选）：代理的工作目录
**示例：**
```json
{
"task": "构建带有身份验证的REST API",
"agents": [
{
"role": "后端开发者",
"instructions": "使用JWT身份验证创建Express.js API"
},
{
"role": "数据库工程师",
"instructions": "设计和实现用户数据库模式"
},
{
"role": "安全审计员",
"instructions": "审查身份验证实现的安全问题"
}
],
"execution_mode": "parallel"
}
```
### `create_goose_recipe`
为专门的子代理创建可重用的Goose配方。
**参数：**
- `recipe_name`（字符串）：配方的名称
- `role`（字符串）：代理角色
- `instructions`（字符串）：详细指令
- `extensions`（数组，可选）：要启用的Goose扩展
- `parameters`（对象，可选）：配方参数
### `list_active_subagents`
列出当前活动的子代理会话及其状态。
### `get_subagent_results`
检索已完成的子代理会话的结果。
**参数：**
- `session_id`（字符串）：要获取结果的会话ID
## 示例工作流程
### 自主全栈开发
```javascript
// 委托一个完整的Web应用开发任务
{
"task": "创建带有React前端和Node.js后端的todo应用",
"agents": [
{
"role": "项目架构师",
"instructions": "设计整体架构并创建项目结构"
},
{
"role": "后端开发者",
"instructions": "构建具有CRUD操作的REST API用于todos"
},
{
"role": "前端开发者",
"instructions": "创建React组件并与API集成"
},
{
"role": "质量工程师",
"instructions": "编写测试并确保质量标准"
}
],
"execution_mode": "sequential"
}
```
### 并行代码审查
```javascript
{
"task": "审查身份验证模块的安全性和性能",
"agents": [
{
"role": "安全审计员",
"instructions": "分析安全漏洞和最佳实践"
},
{
"role": "性能审查员",
"instructions": "识别性能瓶颈和优化机会"
},
{
"role": "代码质量审查员",
"instructions": "检查代码风格、可维护性和文档"
}
],
"execution_mode": "parallel"
}
```
## 代理角色示例
- `后端开发者` - API开发、服务器端逻辑
- `前端开发者` - UI/UX实现、客户端代码
- `数据库工程师` - 模式设计、查询优化
- `DevOps工程师` - 部署、CI/CD、基础设施
- `质量工程师` - 测试、质量保证
- `安全审计员` - 安全审查、漏洞评估
- `代码审查员` - 代码质量、最佳实践
- `文档编写者` - 技术文档、API文档
- `项目架构师` - 系统设计、架构规划
## 环境变量
- `ALPHA_FEATURES=true` - Goose子代理所需
- `GOOSE_RECIPE_PATH` - 自定义配方目录的路径
## 故障排除
1. **子代理不工作**：确保设置了`ALPHA_FEATURES=true`
2. **找不到Goose**：验证Goose CLI是否安装并在PATH中
3. **找不到配方**：检查`GOOSE_RECIPE_PATH`或将配方放在工作目录中
## 许可证
MIT
