AI导哈

AI代理多功能平台

Super-MCP是一个生产级模型上下文协议平台，提供120种技能、54种已验证工具、3种互动游戏、键盘优先的终端用户界面以及完整的可观察性堆栈，适用于各种AI代理的扩展和集成。

  • by RemyLoveLogicAI
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 RemyLoveLogicAI/super-mcp

使用说明

超级MCP

通用MCP平台——规范技能、经过验证的工具、游戏和任何AI代理的一个命令入职培训。

这是什么？

Super MCP是一个生产级模型上下文协议平台，随附 120技能, 54个经过验证的工具, 3互动游戏，先用键盘 文本用户界面，以及一个完整的可观察性堆栈。它与代理无关，完全可审计，可确定性重放，并设计用于扩展。

亮点

层 你得到什么
内核 异步事件总线、通用注册表、声明性安全规则、会话生命周期
技能 跨越代码、数据、安全、DevOps、写作、研究、游戏的120个Skill.md工件
工具 54个工具定义，包括OAuth2+PKCE、健康检查、分类注册表
游戏 D&D任务引擎，选择你自己的冒险（3个故事），佐克风格的互动小说
文本用户界面 基于文本的终端用户界面，带有侧边栏、事件日志、输出窗格、游戏启动器
入职 7步向导：环境检查、OAuth、技能加载、工具验证、健康状况
回放 确定性事件捕获、带注释的捆绑包、速度控制回放
分析 使用情况跟踪、汇总报告、趋势分析、JSON导出
可观测性 计数器、仪表、直方图、与OpenTetry兼容的量程、Prometheus导出
安全 沙盒执行，内存/CPU/超时限制，命令/路径验证
钩子 25+个扩展点，在插件回调之前/之后具有优先级

快速开始

安装

# Clone and install
git clone https://github.com/super-mcp/super-mcp.git
cd super-mcp
pip install -e ".[all]"

推出TUI

smcp tui
# or simply:
smcp

跑步入职培训

smcp onboard

玩游戏

smcp play dnd        # D&D Quest Engine
smcp play adventure  # Choose-Your-Own-Adventure
smcp play zork       # The Ruins of Zyl

CLI参考

所有命令均可通过 super-mcp 或 smcp 别名。

smcp [COMMAND]

Commands:
  tui               Launch the terminal UI (default)
  onboard           Run the onboarding wizard
  play TYPE         Start a game (dnd | adventure | zork)
  skills            List registered skills
  tools             List registered tools
  status            Show kernel status and health
  generate-skills   Generate Skill.md files to disk
  export-report     Export a session analytics report
  metrics           Display observability metrics

Options:
  --help            Show help for any command

例子

smcp skills --filter "security"    # Filter skills by tag
smcp tools --filter "github"       # Filter tools by name
smcp generate-skills --output-dir ./my-skills
smcp export-report --output report.json

文本用户界面

TUI是主要接口。它将侧边栏浏览器、输出窗格、事件日志和游戏集成整合到一个单一的键盘驱动体验中。

键盘快捷键

关键 行动
F1 帮助
F2 焦点技能面板
F3 焦点工具面板
F4 焦点游戏面板
F5 切换事件日志
Ctrl+S 切换侧边栏
Ctrl+L 清晰输出
Ctrl+Q 退出
Esc 焦点输入栏

斜杠命令

命令 描述
/help 显示可用命令
/skills 列出所有加载的技能
/tools 列出所有已注册的工具
/status 内核状态和运行状况
/onboard 启动入职向导
/game <type> 启动游戏(dnd, adventure, zork)
/checkpoint 创建一个命名检查点
/events 显示最近的事件
/clear 清除输出窗格
/quit 退出TUI

当游戏处于活动状态时，任何非斜线输入都会被转发到游戏引擎。类型 /quit 退出游戏并返回命令模式。

游戏

D&D Quest引擎

完整的桌面RPG体验。创建一个角色（战士、法师、盗贼、游侠、牧师），探索程序结构的遭遇战，使用主动滚动进行回合制战斗，并随着进度升级。具有角色表、骰子机制（d4–d20）、休息/治疗系统和boss遭遇战。

选择你自己的冒险

三个完全分支的叙事故事：

  • 水晶洞穴 --探索地下洞穴与生存选择
  • 星际飞船阿尔忒弥斯 --一艘受损船只上的科幻指挥桥决策
  • 魔法图书馆 --神奇的图书馆，有拼图室和隐藏的路径

每个故事有大约20个节点，有多个结局。选择被跟踪和评分。

齐尔废墟（佐克风格）

一款基于解析器的交互式小说游戏，有14个房间、14个项目、5个NPC和一个支持20多个动词的自然语言命令解析器。功能包括暗室（带灯笼或面对敌人）、NPC谜题（谜语、贿赂、战斗）、有重量限制的库存管理、装备的武器和盔甲以及分数/等级系统。你的目标：将Zyl水晶恢复到深金库。

所有游戏支持 撤销/重做, 命名检查点，以及 确定性重放 通过游戏引擎状态管理器。

建筑

超级MCP构建在五层之上：

┌─────────────────────────────────────────┐
│  TUI / CLI                              │  ← User-facing
├─────────────────────────────────────────┤
│  Games / Onboarding                     │  ← Interactive modules
├─────────────────────────────────────────┤
│  Skills / Tools / Hooks                 │  ← Capability layer
├─────────────────────────────────────────┤
│  Replay / Analytics / Observability     │  ← Cross-cutting concerns
├─────────────────────────────────────────┤
│  Kernel (Event Bus, Registries, Safety) │  ← Foundation
└─────────────────────────────────────────┘

这 内核 拥有生命周期(boot → onboard → run → checkpoint → shutdown)，通过异步事件总线发出所有状态更改，并在执行任何工具之前强制执行安全规则。

有关详细的体系结构演练，请参见 建筑.md.

扩展点

超级MCP曝光 25+钩点 对于插件：

  • 生命周期: kernel.boot, kernel.shutdown, session.start, session.end
  • 技能: skill.register, skill.invoke, skill.complete
  • 工具: tool.register, tool.invoke, tool.health_check
  • 事件: event.emit, event.subscribe
  • 安全: safety.check, safety.violation
  • 游戏: game.start, game.input, game.end
  • 入职: onboard.start, onboard.step, onboard.complete

钩子是异步的、有优先级的（较低的数字=较早的执行），并且支持这两种方式 before 和 after 语义。

有关完整的插件开发指南，请参阅 EXTENDING.md.

发展

设置

git clone https://github.com/super-mcp/super-mcp.git
cd super-mcp
pip install -e ".[dev]"

测试

pytest                        # Run all tests
pytest --cov=src              # With coverage
pytest -m "not slow"          # Skip slow tests
pytest tests/unit/            # Unit tests only

棉绒和类型检查

ruff check src/               # Lint
ruff format src/               # Format
mypy src/                      # Type check

生成技能

smcp generate-skills --output-dir ./skills

项目结构

src/
├── cli.py                     # Click CLI entry point
├── kernel/                    # Core: types, event bus, registries, safety, kernel
├── skills/                    # Skill loader and 120-skill catalog generator
├── tools/                     # Tool registry (54 tools) and OAuth2+PKCE manager
├── onboarding/                # 7-step onboarding wizard
├── games/                     # Game engine + 3 games (D&D, Adventure, Zork)
├── tui/                       # Textual TUI app, themes, 6 components
├── replay/                    # Deterministic replay engine
├── analytics/                 # Usage tracking and reporting
├── observability/             # Metrics, counters, histograms, tracing
├── artifacts/                 # Session and artifact export
├── security/                  # Sandboxed execution
└── api/                       # Plugin hook registry

skills/                        # 120 Skill.md artifact files
tests/                         # Unit, integration, and e2e tests

许可证

MIT许可证。看 许可证 了解详情。

相关 MCP