MCP到克劳德技能转换器
这是一个Python脚本，它将MCP（模型上下文协议）服务器转换为Claude Code Skills包。它自动生成包含AI驱动的描述、包装脚本和文档的技能包。
概述
此脚本从Claude的配置文件中读取MCP服务器配置，并将其转换为可与Claude代码一起使用的独立Claude Skills。每个生成的技能包括：
- 用于工具执行的Python包装脚本
- 人工智能生成的技能描述
- 完整的工具参考文档
- 使用说明
特性
- 自动配置检测：扫描不同平台上的标准Claude配置位置
- AI驱动的描述：使用OpenAI兼容的API生成技能描述
- 通用包装生成：创建适用于任何MCP服务器的Python脚本
- 与跨平台支持：适用于macOS、Windows和Linux
- 环境变量支持：从加载配置
.env文件
先决条件
- Python 3.7+
uv包管理器- MCP Python包
python-dotenv（可选，用于.env支持）- OpenAI兼容的API访问（用于AI描述）
安装
- 安装所需的依赖项：
pip install mcp python-dotenv openai- 安装
uv如果尚未安装：
pip install uv配置
创建一个 .env 文件与位于同一目录中 main.py 具有以下变量：
# AI Configuration (for generating skill descriptions)
DS_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://api.deepseek.com
AI_MODEL=deepseek-chat用法
基本用法
运行不带参数的脚本以自动检测Claude的配置：
python main.py指定配置文件
提供特定的配置文件路径：
python main.py /path/to/your/config.json生成的技能结构
对于每个MCP服务器，该脚本创建一个目录结构，如下所示：
mcp_skills/
└── server-name/
├── SKILL.md # Main skill documentation with AI description
├── reference.md # Complete tool reference
└── scripts/
└── server_name_wrapper.py # Python wrapper script生成的文件
- 技能.md：包含技能元数据、AI生成的描述和使用说明
- reference.md：所有可用工具及其模式的详细文档
- scripts/\[服务器\]\_wrapper.py：与MCP服务器交互的Python脚本
使用生成的技能
要使用生成的技能，请使用以下命令执行包装器脚本 uv:
uv run --quiet --with mcp /path/to/skill/scripts/server_wrapper.py "tool_name" '{"arg": "value"}'配置文件检测
该脚本按以下顺序搜索Claude配置文件：
- 命令行提供的路径
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json - 克劳德代码CLI：
~/.claude.json
AI描述生成
当提供API密钥时，脚本使用AI生成技能描述，这些技能描述：
- 总结技能的能力
- 确定主要用例
- 遵循Anthropic的技能描述指南
- 针对Claude代理路由器兼容性进行了优化
如果AI生成失败，则使用服务器名称和顶级工具创建回退描述。
错误处理
该脚本包括以下全面的错误处理：
- 缺少配置文件
- MCP服务器连接失败
- AI API错误
- 文件系统权限
- JSON配置无效
输出
所有生成的技能都放置在 mcp_skills/ 默认情况下为目录。每种技能都是独立的，可以独立使用。
工作流示例
- 地方
main.py在您的项目目录中 - 创建一个
.env使用您的AI API密钥存档 - 跑
python main.py - 在中查找生成的技能
mcp_skills/目录 - 使用提供的技能
uv命令
故障排除
- 未找到配置：确保Claude已安装并已配置
- AI生成失败：在中检查您的API密钥和基本URL
.env文件 - 包装脚本错误：验证MCP服务器是否正确安装且可访问
- 权限错误：确保输出目录的写入权限
依赖项
mcp：模型上下文协议客户端库openai：与OpenAI兼容的API客户端python-dotenv：环境变量加载pathlib：路径操纵asyncio：异步编程支持