# Superpowers MCP 服务器

基于 [superpowers](https://github.com/obra/superpowers) 开发的 MCP (Model Context Protocol) 服务器，为 AI 助手提供强大的扩展能力。

## ✨ 功能特性

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

## 📦 安装方式

### 全局安装
```bash
npm install -g https://github.com/xinyuzjj/superpowers-mcp.git
```

### 源码安装
```bash
git clone https://github.com/xinyuzjj/superpowers-mcp.git
cd superpowers-mcp
npm install
npm run build
npm link
```

## 🚀 使用方法

### 1. 配置到 MCP 客户端

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

#### Trae 配置示例：
```json
{
  "mcpServers": {
    "superpowers": {
      "command": "mcp-superpowers"
    }
  }
}
```

#### Claude Desktop 配置示例：
```json
{
  "mcpServers": {
    "superpowers": {
      "command": "npx",
      "args": ["@xinyuzjj/superpowers-mcp"]
    }
  }
}
```

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

## 🛠️ 可用工具

### `run-superpower-command`
运行 superpowers 命令

**参数说明：**
- `command`: 要执行的 superpowers 命令名称（必填）
- `args`: 命令的参数列表（可选）

**使用示例：**
```json
{
  "name": "run-superpower-command",
  "parameters": {
    "command": "write-plan",
    "args": ["开发一个待办事项应用"]
  }
}
```

### `list-superpower-skills`
列出所有可用的 superpowers 技能

**使用示例：**
```json
{
  "name": "list-superpower-skills",
  "parameters": {}
}
```

## 📚 包含的技能

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

## 🔧 开发指南

### 本地开发
```bash
# 安装依赖
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](LICENSE) 文件了解详情。

## 🙏 致谢

- 感谢 [obra](https://github.com/obra) 开发的原始 [superpowers](https://github.com/obra/superpowers) 项目
- 感谢 MCP 协议提供的标准化扩展能力