AI导哈

技能库服务器

一个使Superpowers技能库可用于任何支持MCP协议的LLM的服务器，提供TDD、系统调试、头脑风暴等多种技能支持。

  • by erophames
  • TypeScript
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 erophames/superpowers-mcp

使用说明

超级大国mcp

MCP服务器 超级大国 任何支持以下内容的法学硕士都可以获得的技能 模型上下文协议.

Superpowers是Claude Code的一个技能库，它强制执行有纪律的工作流程——TDD、系统调试、头脑风暴、规划等等。此服务器将这些技能暴露给任何兼容MCP的客户端：Cursor、Windsurf、Gemini、Kilo Code、Claude Desktop或您自己的应用程序。

快速开始

1.克隆和构建

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

2.运行安装程序

node build/index.js

在终端中首次运行时，安装向导会克隆超级能力存储库并保存配置。

3.配置您的MCP客户端

添加到客户端的MCP服务器配置中：

{
  "mcpServers": {
    "superpowers": {
      "command": "node",
      "args": ["/absolute/path/to/superpowers-mcp/build/index.js"]
    }
  }
}

替换 /absolute/path/to/ 使用克隆存储库的实际路径。

Client-specific config file locations
客户端 配置位置
克劳德桌面 ~/Library/Application Support/Claude/claude_desktop_config.json
克劳德代码 ~/.claude.json 或项目 .mcp.json
光标 光标设置>MCP
风帆冲浪 ~/.codeium/windsurf/mcp_config.json

它揭示了什么

服务器通过所有三个MCP原语注册技能：

工具

工具 说明
list_skills 列出所有可用技能及其说明和文件列表
use_skill 按名称加载技能——返回完整的技能内容作为要遵循的说明（可选护栏强制）
get_skill_file 从技能加载支持文件（参考文档、提示模板、脚本）
recommend_skills 使用语义排名+工作流策略提升为任务推荐顶级技能
compose_workflow 为目标构建有序的多技能工作流程
validate_workflow 根据所需的工作流程护栏验证所选技能
semantic_search_skills 语义搜索 SKILL.md 以及支持文件

提示

每个技能都注册为名为的MCP提示 superpowers:{skill-name}支持提示选择的客户端将在其UI中显示这些内容。选择提示会将全部技能内容注入对话中。

资源

每种技能 SKILL.md 并将支持文件注册为资源：

superpowers://skills/brainstorming/SKILL.md
superpowers://skills/test-driven-development/testing-anti-patterns.md
superpowers://skills/systematic-debugging/root-cause-tracing.md

资源模板 superpowers://skills/{skillName}/{fileName} 允许动态访问任何文件。

可用技能

技能 它做什么
brainstorming 通过问题、方法和增量验证进行协作设计
writing-plans 具有精确文件路径和TDD步骤的小规模实施计划
executing-plans 在任务之间使用审查检查点批量执行计划
subagent-driven-development 每个任务有一个新的子代理，有两个阶段的代码审查
dispatching-parallel-agents 将独立任务分配给并发代理
test-driven-development RED-GREEN-REFACTOR循环——始终先写失败的测试
systematic-debugging 4阶段根本原因分析：修复前进行调查
verification-before-completion 运行命令，读取输出，然后声明结果
requesting-code-review 调度代码审查并根据严重性分类反馈采取行动
receiving-code-review 接收反馈时的技术严谨性——验证，不要盲目同意
using-git-worktrees 用于并行特征开发的隔离git工作树
finishing-a-development-branch 完成合并、PR或清理后的结构化选项
writing-skills 创建、测试和部署新技能的框架
using-superpowers 技能系统如何工作以及何时调用技能

使用示例

连接后，询问您的AI助手：

  • “有什么超能力技能可用？”（电话 list_skills)
  • “使用头脑风暴技巧来帮助我设计缓存层。”
  • “加载TDD技能并按照它来实现此功能。”
  • “从测试驱动开发技能中读取反模式文件。”
  • “推荐实现此MCP功能的最佳技能。”
  • “编写调试不稳定测试的工作流程。”
  • “验证此工作流程：头脑风暴、编写计划、测试驱动开发。”
  • “搜索根本原因追踪技术的技能。”

配置

环境变量

变量 描述
SUPERPOWERS_SKILLS_DIR 直接覆盖技能目录路径

技能发现顺序

  1. SUPERPOWERS_SKILLS_DIR 环境变量
  2. 安装向导中保存的目录（保存在 ~/.config/superpowers-mcp)
  3. 克劳德代码插件缓存(~/.claude/plugins/cache/claude-plugins-official/superpowers/*/skills/)

自动更新

当技能来源于git存储库时，服务器在启动时每天检查一次更新，并自动提取新的更改。

发展

npm install
npm run build
npm test
脚本 描述
npm run build 编译TypeScript
npm run dev 观看模式编译
npm test 运行所有58个测试
npm run test:watch 观看模式测试
npm start 运行服务器

建筑

src/
  index.ts                  Entry point, stdio transport, setup and update orchestration
  server.ts                 McpServer creation, composes all registrations
  config.ts                 Persistent configuration
  update.ts                 Daily auto-update check
  git.ts                    Git operations (clone, pull, fetch) via execFile
  cli/setup.ts              Interactive setup wizard
  skills/
    types.ts                Skill, SkillFile, SkillMetadata interfaces
    discovery.ts            Directory scanning, YAML frontmatter parsing, version resolution
  tools/register.ts         list_skills, use_skill, get_skill_file
  prompts/register.ts       One MCP prompt per skill
  resources/register.ts     Static resources per file + resource template for dynamic access

测试

许可证

麻省理工学院

相关 MCP