Agent Squared

Agent²（Agent Squared）

Cursor的多代理编排——将专门的AI代理链接在一起，以实现复杂的开发工作流程。

 

什么是Agent²？

Agent²是一个MCP（模型上下文协议）服务器，它通过多代理功能扩展了Cursor。Agent²不是用一个提示来处理所有事情，而是通过专门的代理智能地路由您的任务：

Your Task → Splitter → Prompt Engineer → Specialist Agent(s) → Composer → Result
              ↓              ↓                    ↓                ↓
        Decompose       Optimize           Execute work      Validate
        the task        the prompt         (frontend,        integration
                                           backend, etc.)

快速开始

1.安装依赖项

cd mcp
pip install -r requirements.txt

2.获取光标API密钥

1. 打开 光标设置 （Cmd/Ctrl+，）
2. 首选 特性 → API密钥
3. 生成新的API密钥

3.配置MCP

添加到您的光标MCP配置 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agent-squared": {
      "command": "python",
      "args": ["/path/to/agent-squared/mcp/mcp_server.py"],
      "env": {
        "CURSOR_API_KEY": "your-cursor-api-key-here",
        "CURSOR_MODEL": "composer-1"
      }
    }
  }
}

4.重新启动游标

重新启动Cursor以加载MCP服务器。

5.开始使用Agent²

在Cursor聊天中，只需说：

“使用agent_squared生成带有身份验证的REST API”

或者先测试连接：

“使用test_cursor_mcp检查agent_squared是否正常工作”

______________________________________________________________________

使用示例

简单的任务

“使用agent_squared将暗模式切换添加到设置页面”

复杂的全栈任务

“使用agent_squared构建一个用户仪表板，其中包含： - 用于用户统计的后端API - 带有图表的React前端 - 身份验证中间件”

基础设施任务

“使用agent_squared使用GitHub Actions设置CI/CD管道并部署到AWS ECS”

______________________________________________________________________

可用代理

添加自定义代理

您可以通过创建来添加自己的专业代理 .md 文件在 agents/ 文件夹。任何尚未映射到内置代理的markdown文件都将被自动发现。

1.创建您的代理文件：

# Create agents/my-agent.md
touch agents/my-agent.md

2.添加封面和说明：

---
name: my-agent
description: Brief description of what your agent does (used by the splitter)
tools: Read, Write, Edit, Bash
model: sonnet
---

You are a specialist in [your domain].

When given a task, you should:
1. [Your approach]
2. [Your approach]

[Additional instructions...]

3.重新启动游标 重新加载MCP服务器

4.验证是否发现：

“使用list_agents显示可用代理”

您的客服将出现在 海关代理 拆分器将根据您的描述在相关时自动推荐。

______________________________________________________________________

MCP工具参考

逐步控制

为了更好地控制管道，您可以单独调用工具：

1. split_task –查看需要哪些代理
2. perfect_prompt –优化任务描述
3. run_specialist –执行每个代理
4. compose_agents –验证集成

______________________________________________________________________

配置

环境变量

自定义模型

要使用其他模型，请执行以下操作：

{
  "mcpServers": {
    "agent-squared": {
      "command": "python",
      "args": ["/path/to/agent-squared/mcp/mcp_server.py"],
      "env": {
        "CURSOR_API_KEY": "your-key",
        "CURSOR_MODEL": "claude-sonnet-4"
      }
    }
  }
}

______________________________________________________________________

项目结构

agent-squared/
├── mcp/                      # MCP server implementation
│   ├── mcp_server.py         # Main MCP server
│   ├── agent_chain/          # Agent orchestration logic
│   ├── tools/                # MCP tool handlers
│   ├── utils/                # Helper utilities
│   └── requirements.txt      # Python dependencies
├── agents/                   # Agent instruction files
│   ├── splitter-agent.md
│   ├── prompt-engineer.md
│   ├── composer.md
│   └── ... (specialist agents)
└── README.md

______________________________________________________________________

运作原理

管道

1. 拆分剂 分析你的任务并确定需要哪些专家
2. 提示工程师 优化您的提示，使其清晰和具体
3. 专业代理 执行实际工作（编码、基础设施等）
4. 作曲家代理 验证所有部分是否正确集成

为什么选择多代理？

在复杂的任务中，单个提示会碰壁。通过跨专业代理分解工作：

• 每个代理都有专注的专业知识和指导
• 复杂的任务被分解为可管理的部分
• 集成已明确验证
• 你得到的结果比一次提示更好

______________________________________________________________________

故障排除

“代理执行超时”

1. 跑 test_cursor_mcp 检查您的设置
2. 验证您的 CURSOR_API_KEY 有效
3. 检查 cursor-agent 已安装： which cursor-agent

“找不到游标代理”

安装Cursor CLI：

curl https://cursor.com/install -fsS | bash

工具未出现在光标中

1. 检查 ~/.cursor/mcp.json 语法
2. 验证路径 mcp_server.py 是正确的
3. 完全重新启动游标

______________________________________________________________________

贡献

欢迎投稿！请随意：

• 添加新的专业代理
• 改进现有的代理说明
• 修复错误或改进错误处理
• 添加文档

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证 了解详情。