Agent Q

代理人Q

通过模型上下文协议（MCP）进行专业人工智能代理管理

](https://www.npmjs.com/package/@notsooshariff/agent-q)  

概述

Agent Q是一个模型上下文协议（MCP）服务器，使您能够为任何兼容MCP的AI工具创建、管理和组织专门的AI代理。agent Q拥有120多个预构建的代理模板，涵盖从代码审查到DevOps的所有内容，可帮助您简化AI工作流程。

兼容性说明Agent Q基于开放的MCP标准构建，旨在与所有MCP兼容的工具协同工作。然而，它主要是通过以下方式开发和测试的 克劳德代码。我们正在积极寻找贡献者，以帮助测试和提高与Cursor、Cline等其他MCP客户端的兼容性。如果您想捐款，请查看我们的 贡献指南.

主要特点

• 120+代理模板 -预先配置的专家随时可用
• 完整的代理生命周期 -创建、更新、删除和管理代理
• 符合MCP标准 -可与任何兼容MCP的AI工具配合使用
• 注重安全 -路径验证和内容清理
• TypeScript优先 -完全类型安全和IntelliSense支持
• 零配置 -使用合理的默认值即可开箱即用

快速开始

安装

# Using npx (recommended)
npx @notsooshariff/agent-q

# Or install globally
npm install -g @notsooshariff/agent-q

配置

将Agent Q添加到您的MCP兼容AI工具中：

标准配置：

{
  "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：

claude mcp add agent-q npx @notsooshariff/agent-q

或手动编辑 ~/.claude/config.json 使用标准配置。

VS Code (with Copilot)

通过VS Code CLI安装：

code --add-mcp '{"name":"agent-q","command":"npx","args":["-y","@notsooshariff/agent-q"]}'

或者按照MCP安装指南使用标准配置。

Cursor

1. 转到光标设置→ MCP → 添加新的MCP服务器
2. 姓名： agent-q
3. 命令类型： npx @notsooshariff/agent-q
4. 点击“添加”

Amp (VS Code Extension)

更新您的 settings.json:

"amp.mcpServers": {
  "agent-q": {
    "command": "npx",
    "args": ["-y", "@notsooshariff/agent-q"]
  }
}

或者使用CLI：

amp mcp add agent-q -- npx @notsooshariff/agent-q

Goose

1. 转到高级设置→ 扩展→ 添加自定义扩展名
2. 姓名： agent-q
3. 类型：STDIO
4. 命令： npx @notsooshariff/agent-q
5. 点击“添加扩展名”

Codex

使用CLI：

codex mcp add agent-q npx "@notsooshariff/agent-q"

或编辑 ~/.codex/config.toml:

[mcp_servers.agent-q]
command = "npx"
args = ["-y", "@notsooshariff/agent-q"]

Factory

使用CLI：

droid mcp add agent-q "npx @notsooshariff/agent-q"

或类型 /mcp 在Factory droid中用于交互式UI。

Kiro

编辑 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "agent-q": {
      "command": "npx",
      "args": ["-y", "@notsooshariff/agent-q"]
    }
  }
}

opencode

编辑 ~/.config/opencode/opencode.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工具：

// 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

设置

# 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

项目命令

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客户端的支持
2. 代理模板：为不同域添加新的专用代理模板
3. 文档：改进各种工具的设置指南和故障排除
4. 错误报告：在不同平台上进行测试并报告问题

请看 贡献.md 详细指南。

添加新模板

1. 在中创建新目录 templates/
2. 添加一个 agent.md 包含代理配置的文件
3. 包含README.md和文档
4. 提交拉取请求

许可证

麻省理工学院©特工Q团队

致谢

内置：

• 模型上下文协议SDK
• TypeScript
• Turborepo
• pnpm

______________________________________________________________________

准备好增强你的人工智能工作流程了吗？ 立即安装Agent Q！

npx @notsooshariff/agent-q