星战科技xingzhan.cloud
返回市场
代理-q

代理-q

作者：NotSooShariff14 星标更新：2025-11-15
安装使用来源：spider==github.com

项目介绍

Agent Q

通过模型上下文协议（MCP）实现专业AI代理管理

npm 版本 许可证：MIT TypeScript

概述

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

关于兼容性的说明：Agent Q 基于开放的MCP标准构建，并旨在与所有MCP兼容工具一起使用。然而，它主要针对 Claude Code 进行了开发和测试。我们正在积极寻找贡献者来帮助测试并提高与其他MCP客户端如Cursor、Cline等的兼容性。如果您想做出贡献，请参阅我们的贡献指南。

主要功能

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

快速开始

安装

# 使用npx（推荐）
npx @notsooshariff/agent-q

# 或全局安装
npm install -g @notsooshariff/agent-q

配置

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

标准配置：

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

工具特定设置

<details> <summary><b>Claude Desktop</b></summary>

编辑您的配置文件：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

添加上述标准配置。

</details> <details> <summary><b>Claude Code</b></summary>

使用CLI添加Agent Q：

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

或手动编辑 ~/.claude/config.json 并添加标准配置。

</details> <details> <summary><b>VS Code（带Copilot）</b></summary>

通过VS Code CLI安装：

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

或遵循MCP安装指南并使用标准配置。

</details> <details> <summary><b>Cursor</b></summary>
  1. 转到Cursor设置 → MCP → 添加新MCP服务器
  2. 名称：agent-q
  3. 命令类型：npx @notsooshariff/agent-q
  4. 点击“添加”
</details> <details> <summary><b>Amp（VS Code扩展）</b></summary>

更新您的 settings.json：

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

或使用CLI：

amp mcp add agent-q -- npx @notsooshariff/agent-q
</details> <details> <summary><b>Goose</b></summary>
  1. 转到高级设置 → 扩展 → 添加自定义扩展
  2. 名称：agent-q
  3. 类型：STDIO
  4. 命令：npx @notsooshariff/agent-q
  5. 点击“添加扩展”
</details> <details> <summary><b>Codex</b></summary>

使用CLI：

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

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

[mcp_servers.agent-q]
command = "npx"
args = ["-y", "@notsooshariff/agent-q"]
</details> <details> <summary><b>Factory</b></summary>

使用CLI：

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

或在Factory droid内键入 /mcp 以获取交互式UI。

</details> <details> <summary><b>Kiro</b></summary>

编辑 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "agent-q": {
      "command": "npx",
      "args": ["-y", "@notsooshariff/agent-q"]
    }
  }
}
</details> <details> <summary><b>opencode</b></summary>

编辑 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agent-q": {
      "type": "local",
      "command": ["npx", "@notsooshariff/agent-q"],
      "enabled": true
    }
  }
}
</details> <details> <summary><b>Windsurf</b></summary>

遵循Windsurf MCP文档并使用上述标准配置。

</details> <details> <summary><b>Warp</b></summary>

转到设置 → AI → 管理MCP服务器 → + 添加

或使用斜杠命令 /add-mcp 并粘贴标准配置。

</details> <details> <summary><b>LM Studio</b></summary>

转到程序（右侧边栏）→ 安装 → 编辑mcp.json

使用上述标准配置。

</details>

可用工具

Agent Q 提供了7个MCP工具用于管理您的代理：

核心工具

  • create_agent - 创建具有自定义个性和行为的新专门代理
  • update_agent - 修改现有代理的配置
  • delete_agent - 删除代理
  • list_agents - 查看所有可用代理（项目和用户范围）
  • validate_agent - 检查代理配置是否有效

模板工具

  • install_template - 从模板库安装代理
  • search_templates - 按类别浏览可用模板

代理模板

Agent Q 包含120+ 预构建代理模板，覆盖多个类别：

开发与工程

  • 后端开发者，前端开发者，全栈开发者
  • 移动开发者，游戏开发者，嵌入式系统开发者
  • Python专家，TypeScript专家，Go专家，Rust专家
  • React专家，Node.js专家，GraphQL专家

DevOps与基础设施

  • DevOps工程师，SRE，平台工程师
  • 云架构师，容器安全专家
  • CI/CD工程师，配置管理员
  • 监控专家，灾难恢复专家

安全与合规

  • 安全分析师，安全架构师，渗透测试员
  • 密码学专家，OWASP专家
  • 漏洞研究员，威胁建模师
  • 认证专家，授权专家
  • 合规审计员，许可证合规检查员

质量与测试

  • QA工程师，自动化测试工程师
  • 端到端测试员，性能测试员，可访问性测试员
  • 混沌工程师，兼容性测试员
  • Bug猎人，静态分析专家

数据与分析

  • 数据工程师，数据科学家，数据分析师
  • 机器学习工程师，大数据工程师
  • 分析工程师，BI分析师
  • ETL开发人员，数据可视化专家

架构与设计

  • 系统架构师，软件架构师，微服务架构师
  • API设计师，数据库管理员
  • 设计系统架构师，缓存架构师

文档与内容

  • 技术作家，文档专家
  • 教程创作者，README编写者
  • 架构文档撰写者，代码注释者
  • 发布说明撰写者，维基维护者

项目管理

  • 工程经理，技术负责人，Scrum主管
  • 产品经理，项目经理，敏捷教练
  • 发布经理，项目组合经理

专门角色

  • 代码审查员，结对编程者，调试器
  • 性能工程师，内存管理专家
  • 重构专家，遗留代码专家
  • 技术债务管理者，依赖审核员

...还有很多！

使用示例

安装后，您的AI工具可以自动调用Agent Q工具：

// 创建专门的代码审查代理
用户："创建一个专注于安全的代码审查代理"

AI：[使用Agent Q的create_agent工具]
✅ 代理已创建：security-code-reviewer
📍 位置：.claude/agents/security-code-reviewer.md
🔧 工具：Read, Grep, Glob

// 从模板安装
用户："安装devops工程师模板"

AI：[使用Agent Q的install_template工具]
✅ 已安装：devops-engineer

项目结构

agent-q/
├── packages/
│   ├── core/           # 核心业务逻辑
│   │   ├── agent/      # 代理管理
│   │   ├── security/   # 安全与验证
│   │   ├── template/   # 模板系统
│   │   └── config/     # 配置
│   │
│   ├── mcp-server/     # MCP服务器实现
│   │   └── tools/      # 7个MCP工具
│   │
│   └── plugin/         # 插件包
│
└── templates/          # 120+ 代理模板

代理范围

代理可以存储在两个范围内：

  • 项目范围（.claude/agents/） - 通过git与团队共享
  • 用户范围（~/.claude/agents/） - 存储在您的主目录中的个人代理

安全

Agent Q 包含多层安全措施：

  • 路径验证 - 防止目录遍历攻击
  • 内容净化 - 阻止XSS和注入尝试
  • 输入验证 - 类型检查和格式验证
  • 权限检查 - 文件系统安全性验证

开发

先决条件

  • Node.js ≥ 18.0.0
  • pnpm ≥ 9.0.0

设置

# 克隆仓库
git clone https://github.com/NotSooShariff/agent-q.git
cd agent-q

# 安装依赖
pnpm install

# 构建所有包
pnpm build

# 运行测试
pnpm test

项目命令

pnpm build          # 构建所有包
pnpm dev            # 开发监视模式
pnpm test           # 运行测试套件
pnpm lint           # 代码检查
pnpm type-check     # TypeScript类型检查
pnpm clean          # 清理构建工件

要求

  • Node.js 18或更高版本
  • npm 9或更高版本
  • 一个MCP兼容的AI工具

贡献

我们欢迎贡献！Agent Q 是开源且社区驱动的。

优先领域

我们特别需要帮助的是：

  1. MCP客户端兼容性：测试并改进对Cursor、Cline、Windsurf和其他MCP客户端的支持
  2. 代理模板：为不同领域添加新的专门代理模板
  3. 文档：改善各种工具的设置指南和故障排除
  4. 错误报告：在不同平台上进行测试并报告问题

请参阅贡献指南以获取详细指导。

添加新模板

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

许可证

MIT © Agent Q 团队

致谢

使用以下工具构建：

准备好加速您的AI工作流程了吗？ 今天就安装Agent Q！

npx @notsooshariff/agent-q