代理人Q
> 通过模型上下文协议（MCP）进行专业人工智能代理管理
概述
Agent Q是一个模型上下文协议（MCP）服务器，使您能够为任何兼容MCP的AI工具创建、管理和组织专门的AI代理。agent Q拥有120多个预构建的代理模板，涵盖从代码审查到DevOps的所有内容，可帮助您简化AI工作流程。
> 兼容性说明Agent Q基于开放的MCP标准构建，旨在与所有MCP兼容的工具协同工作。然而，它主要是通过以下方式开发和测试的 克劳德代码。我们正在积极寻找贡献者，以帮助测试和提高与Cursor、Cline等其他MCP客户端的兼容性。如果您想捐款，请查看我们的 贡献指南.
主要特点
- 120+代理模板 -预先配置的专家随时可用
- 完整的代理生命周期 -创建、更新、删除和管理代理
- 符合MCP标准 -可与任何兼容MCP的AI工具配合使用
- 注重安全 -路径验证和内容清理
- TypeScript优先 -完全类型安全和IntelliSense支持
- 零配置 -使用合理的默认值即可开箱即用
快速开始
安装```bash
Using npx (recommended)
npx @notsooshariff/agent-q
Or install globally
npm install -g @notsooshariff/agent-q
### 配置
将Agent Q添加到您的MCP兼容AI工具中：
**标准配置：**```json
{
"mcpServers": {
"agent-q": {
"command": "npx",
"args": ["-y", "@notsooshariff/agent-q"]
}
}
}
工具特定设置
Claude Desktop
编辑配置文件：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json
添加上面的标准配置。
Claude Code
使用CLI添加Agent Q：```bash
claude mcp add agent-q npx @notsooshariff/agent-q
或手动编辑 `~/.claude/config.json` 使用标准配置。
VS Code (with Copilot)
通过VS Code CLI安装：```bash
code --add-mcp '{"name":"agent-q","command":"npx","args":["-y","@notsooshariff/agent-q"]}'
或者按照MCP安装指南使用标准配置。
Cursor
- 转到光标设置→ MCP → 添加新的MCP服务器
- 姓名：
agent-q - 命令类型：
npx @notsooshariff/agent-q - 点击“添加”
Amp (VS Code Extension)
更新您的 settings.json:```json
"amp.mcpServers": {
"agent-q": {
"command": "npx",
"args": ["-y", "@notsooshariff/agent-q"]
}
}
或者使用CLI：```bash
amp mcp add agent-q -- npx @notsooshariff/agent-q
Goose
- 转到高级设置→ 扩展→ 添加自定义扩展名
- 姓名：
agent-q - 类型：STDIO
- 命令：
npx @notsooshariff/agent-q - 点击“添加扩展名”
Codex
使用CLI：```bash
codex mcp add agent-q npx "@notsooshariff/agent-q"
或编辑 `~/.codex/config.toml`:```toml
[mcp_servers.agent-q]
command = "npx"
args = ["-y", "@notsooshariff/agent-q"]
Factory
使用CLI：```bash
droid mcp add agent-q "npx @notsooshariff/agent-q"
或类型 `/mcp` 在Factory droid中用于交互式UI。
Kiro
编辑 `.kiro/settings/mcp.json`:```json
{
"mcpServers": {
"agent-q": {
"command": "npx",
"args": ["-y", "@notsooshariff/agent-q"]
}
}
}
opencode
编辑 ~/.config/opencode/opencode.json:```json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"agent-q": {
"type": "local",
"command": ["npx", "@notsooshariff/agent-q"],
"enabled": true
}
}
}
Windsurf
遵循Windsurf MCP文档并使用上述标准配置。
Warp
前往设置→ AI → 管理MCP服务器→ + Add
或者使用斜线命令 `/add-mcp` 并粘贴标准配置。
LM Studio
转到程序（右侧边栏）→ 安装→ 编辑mcp.json
使用上面的标准配置。
## 可用工具
Agent Q提供7个MCP工具来管理您的代理：
### 核心工具
- **`create_agent`** -创建具有定制个性和行为的新专业代理
- **`update_agent`** -修改现有代理的配置
- **`delete_agent`** -删除代理
- **`list_agents`** -查看所有可用代理（项目和用户范围）
- **`validate_agent`** -检查代理配置是否有效
### 模板工具
- **`install_template`** -从模板库安装代理
- **`search_templates`** -按类别浏览可用模板
## 代理模板
代理Q包括 **120+预构建代理模板** 跨越多个类别：
### 开发与工程
- 后端开发人员、前端开发人员、全栈开发人员
- 移动开发人员、游戏开发人员、嵌入式系统开发人员
- Python专家、TypeScript专家、Go专家、Rust专家
- React专家、Node.js专家、GraphQL专家
### DevOps和基础设施
- DevOps工程师、SRE、平台工程师
- 云架构师、容器安全专家
- CI/CD工程师、配置经理
- 监控专家、灾难恢复专家
### 安全与合规
- 安全分析师、安全架构师、渗透测试人员
- 密码学专家、OWASP专家
- 漏洞研究员、威胁建模师
- 身份验证专家、授权专家
- 合规性审核员、许可证合规性检查器
### 质量与测试
- QA工程师、测试自动化工程师
- E2E测试仪、性能测试仪、可访问性测试仪
- 混沌工程师、兼容性测试人员
- Bug Hunter，静态分析专家
### 数据与分析
- 数据工程师、数据科学家、数据分析师
- 机器学习工程师、大数据工程师
- 分析工程师、BI分析师
- ETL开发人员、数据可视化专家
### 建筑与设计
- 系统架构师、软件架构师、微服务架构师
- API设计器、数据库管理员
- 设计系统架构师、缓存架构师
### 文件和内容
- 技术作家、文档专家
- 教程创建者、README编写者
- 架构文档管理员、代码注释员
- 发布说明编写者、Wiki维护者
### 项目管理
- 工程经理、技术负责人、Scrum Master
- 产品经理、项目经理、敏捷教练
- 发布经理、项目经理
### 专业角色
- 代码审查员、结对程序员、调试器
- 性能工程师、内存管理专家
- 重构专家、遗留代码专家
- 技术债务经理、依赖性审计师
_…还有更多！_
## 用法示例
安装后，您的AI工具可以自动调用Agent Q工具：```typescript
// Creating a specialized code review agent
User: "Create a security-focused code review agent"
AI: [Uses Agent Q's create_agent tool]
✅ Agent created: security-code-reviewer
📍 Location: .claude/agents/security-code-reviewer.md
🔧 Tools: Read, Grep, Glob
// Installing from templates
User: "Install the devops engineer template"
AI: [Uses Agent Q's install_template tool]
✅ Installed: devops-engineer
项目结构```
agent-q/
├── packages/
│ ├── core/ # Core business logic
│ │ ├── agent/ # Agent management
│ │ ├── security/ # Security & validation
│ │ ├── template/ # Template system
│ │ └── config/ # Configuration
│ │
│ ├── mcp-server/ # MCP server implementation
│ │ └── tools/ # 7 MCP tools
│ │
│ └── plugin/ # Plugin bundle
│
└── templates/ # 120+ agent templates
## 代理范围
代理可以存储在两个作用域中：
- **项目范围** (`.claude/agents/`)-通过git与您的团队共享
- **用户范围** (`~/.claude/agents/`)-存储在主目录中的个人代理
## 安全
Agent Q包括多个安全层：
- **路径验证** -防止目录遍历攻击
- **内容消毒** -阻止XSS和注入尝试
- **输入验证** -类型检查和格式验证
- **权限检查** -文件系统安全验证
## 发展
### 先决条件
- Node.js≥18.0.0
- pnpm≥9.0.0
### 设置```bash
# Clone the repository
git clone https://github.com/NotSooShariff/agent-q.git
cd agent-q
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run tests
pnpm test
项目命令```bash
pnpm build # Build all packages
pnpm dev # Watch mode for development
pnpm test # Run test suite
pnpm lint # Lint code
pnpm type-check # TypeScript type checking
pnpm clean # Clean build artifacts
## 需求
- Node.js 18或更高版本
- npm 9或更高版本
- 与MCP兼容的AI工具
## 贡献
我们欢迎捐款！Agent Q是开源和社区驱动的。
### 优先领域
我们特别寻求以下方面的帮助：
1. **MCP客户端兼容性**：测试和改进对Cursor、Cline、Windsurf和其他MCP客户端的支持
1. **代理模板**：为不同域添加新的专用代理模板
1. **文档**：改进各种工具的设置指南和故障排除
1. **错误报告**：在不同平台上进行测试并报告问题
请看 贡献.md 详细指南。
### 添加新模板
1. 在中创建新目录 `templates/`
1. 添加一个 `agent.md` 包含代理配置的文件
1. 包含README.md和文档
1. 提交拉取请求
## 许可证
麻省理工学院©特工Q团队
## 致谢
内置：
- 模型上下文协议SDK
- TypeScript
- Turborepo
- pnpm
______________________________________________________________________
**准备好增强你的人工智能工作流程了吗？** 立即安装Agent Q！```bash
npx @notsooshariff/agent-q
