Superpowers

基于 superpowers 开发的 MCP (Model Context Protocol) 服务器，为 AI 助手提供强大的扩展能力。

✨ 功能特性

• 🚀 将 superpowers 的完整功能暴露为 MCP 工具
• 🛠️ 无缝集成所有支持 MCP 协议的 AI 助手
• 🔌 完美适配 Trae、Claude Desktop、Codex、Cursor 等平台
• 📦 开箱即用，无需复杂配置
• 🔧 支持所有 superpowers 原生命令和技能

📦 安装方式

全局安装

npm install -g https://github.com/xinyuzjj/superpowers-mcp.git

源码安装

git clone https://github.com/xinyuzjj/superpowers-mcp.git
cd superpowers-mcp
npm install
npm run build
npm link

🚀 使用方法

1. 配置到 MCP 客户端

在你的 MCP 客户端配置文件中添加以下内容：

Trae 配置示例：

{
  "mcpServers": {
    "superpowers": {
      "command": "mcp-superpowers"
    }
  }
}

Claude Desktop 配置示例：

{
  "mcpServers": {
    "superpowers": {
      "command": "npx",
      "args": ["@xinyuzjj/superpowers-mcp"]
    }
  }
}

2. 重启 AI 助手

配置完成后，重启你的 AI 助手即可开始使用 superpowers 功能。

🛠️ 可用工具

run-superpower-command

运行 superpowers 命令

参数说明：

• command: 要执行的 superpowers 命令名称（必填）
• args: 命令的参数列表（可选）

使用示例：

{
  "name": "run-superpower-command",
  "parameters": {
    "command": "write-plan",
    "args": ["开发一个待办事项应用"]
  }
}

list-superpower-skills

列出所有可用的 superpowers 技能

使用示例：

{
  "name": "list-superpower-skills",
  "parameters": {}
}

📚 包含的技能

Superpowers 内置了丰富的开发技能：

• 🧠 头脑风暴技能
• 📋 计划编写技能
• ⚡ 计划执行技能
• 🔍 系统性调试技能
• 🧪 测试驱动开发技能
• 👥 子代理并行开发技能
• 📝 代码评审技能
• 🔄 Git 工作流技能
• ✅ 完成前验证技能
• 📖 技能编写技能

🔧 开发指南

本地开发

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式（自动监听文件变化）
npm run dev

# 运行测试
npm test

项目结构

superpowers-mcp/
├── src/
│   └── index.ts          # MCP 服务器主入口
├── skills/               # 所有 superpowers 技能文件
├── commands/             # 内置命令定义
├── agents/               # 代理配置
├── dist/                 # 编译输出目录
├── package.json
├── tsconfig.json
└── README.md

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

本项目基于 MIT 许可证开源 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 感谢 obra 开发的原始 superpowers 项目
• 感谢 MCP 协议提供的标准化扩展能力