AI导哈

MCP工具包

一个基于FastMCP的统一Python MCP服务器，集成了UI/UX设计智能、命令套件和开发技能三大工具包，适用于Claude Desktop、Claude Code和claude.ai平台。

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

使用说明

MCP工具包

概述

基于FastMCP构建的统一Python MCP（模型上下文协议）服务器，向Claude Desktop、Claude Code和Claude.ai公开了三个集成工具包： UI/UX Pro Max 设计智能， 克劳德指挥套件 （斜线命令+AI代理），以及 超能力 发展技能。一台服务器、一个配置、14个工具，涵盖设计系统生成、特定于堆栈的UI指南、可浏览的命令/代理库和可组合的开发技能（TDD、调试、代码审查、规划）。

状态

工作 --服务器通过stdio、SSE或流式HTTP运行； start.sh 通过Cloudflare隧道发布它以进行claude.ai集成。

暴露的14个工具：

组 工具
UI/UX Pro Max uiux_search, uiux_design_system, uiux_stack_guidelines, uiux_list_domains
命令套件 list_commands, get_command, search_commands, list_agents, get_agent
超级大国 list_skills, get_skill, get_skill_file, search_skills, get_workflow

内容清单：

  • 命令：26个命名空间（开发、测试、部署、安全、项目、信任、精简、模拟、文档、团队、性能、内存、推理、wfgy等）
  • 代理：40多名专业代理（代码审核员、测试工程师、发布经理、瘦*、swift macos专家、wfgy、技能建设者、数据人工智能、基础设施等）
  • 技能：31个Superpowers SKILL.md文件夹（头脑风暴、系统调试、测试驱动开发、编写计划、前端设计、mcp构建器、webapp测试等）
  • UI/UX数据：风格的CSV、161个调色板、排版配对、图表、产品类型、UX指南、React/web模式、Google字体、提示模板等等 react-native 堆栈指南

设置和运行

# Install (only FastMCP required)
pip install -r requirements.txt

克劳德桌面（stdio）

fastmcp run server.py

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-toolkit": {
      "command": "python3",
      "args": ["-m", "fastmcp", "run", "/absolute/path/to/mcp-toolkit/server.py"]
    }
  }
}

克劳德代码

claude mcp add mcp-toolkit -- python3 -m fastmcp run /absolute/path/to/server.py

claude.ai（通过Cloudflare隧道远程访问）

./start.sh              # server on :8100 + cloudflared tunnel (prints trycloudflare.com URL)
./start.sh --no-tunnel  # local-only

然后在claude.ai中：设置→ 集成→ 添加自定义MCP→ 粘贴 https://…trycloudflare.com/mcp URL。

手动替代方案： fastmcp run server.py -t sse --port 8100 或 -t streamable-http.

建筑

mcp-toolkit/
├── server.py          # FastMCP server, 14 @mcp.tool() definitions (UIUX / Commands / Skills)
├── start.sh           # Boots streamable-http server + Cloudflare tunnel, prints public URL
├── requirements.txt   # fastmcp>=3.0.0
├── agents/            # 40+ agent .md files (flat + subdirs: development, security, business, …)
├── commands/          # 26 namespaces of slash-command .md files (dev, test, deploy, rust, svelte, …)
├── skills/            # 31 Superpowers skills, each a folder with SKILL.md + supporting files
├── uiux_data/         # CSVs: styles, colors, typography, charts, products, UX, stacks
└── uiux_scripts/      # core.py, design_system.py, search.py — imported by server.py

接线注意事项： server.py 补丁 sys.path 和 core.DATA_DIR 所以捆绑 uiux_scripts/ 模块解析 uiux_data/ 不管cwd。

刀具表面：

  • uiux_search(query, domain, max_results) --自动检测到12个域
  • uiux_design_system(query, project_name) --完整的设计系统标记（颜色/排版/间距/组件）
  • uiux_stack_guidelines(query, stack) --目前 react-native
  • list_commands / get_command / search_commands --步行 commands/<ns>/*.md
  • list_agents / get_agent --步行 agents/**/*.md，解析前体 description:
  • list_skills / get_skill / get_skill_file / search_skills --步行 skills/*/SKILL.md
  • get_workflow(workflow) --精心策划的多技能食谱 feature | bugfix | refactor | review

路线图

  • []展开 uiux_stack_guidelines 超越 react-native （React、Next.js、Vue、Svelte、SwiftUI、Flutter、Tailwind、shadcn/ui、HTML/CSS）
  • []缓存 _get_agents() / _get_namespaces() / SUPERPOWERS walks--当前每次调用工具时都会重新扫描磁盘
  • []制造 SUPERPOWERS 设置施工惰性；它在导入时运行，如果 skills/ 永远不见了
  • []替换中的硬编码Python路径 start.sh (/Library/Frameworks/Python.framework/Versions/3.11/bin/python3)使用venv或 $(command -v python3)
  • []公共Cloudflare隧道端点的身份验证/访问控制
  • []健康检查+重新连接逻辑 start.sh （目前已修复 sleep 8 用于隧道URL解析）
  • []为大型静态内容添加MCP资源（而不仅仅是工具）——设计系统CSV、代理/技能目录
  • []测试--尚不存在测试套件

已知Bug

  • 装运工具代码中未标识。（TODO标记位于 commands/skills/scripts/init_skill.py 和 quick_validate.py 是技能建设者有意搭建的模板脚手架，而不是缺陷。)
  • 未成年人： SUPERPOWERS = {…} 在模块顶层将提高 FileNotFoundError 如果 skills/ 不存在——仅与部署时间有关。
  • 未成年人： start.sh 在固定的8秒睡眠后解析隧道URL；缓慢的cloudflared初创公司可能会离开 TUNNEL_URL 空的。

相关 MCP