AI导哈

MCP转Claude技能工具

一个将MCP服务器配置转换为Claude技能包的Python脚本，包含自动生成AI描述、封装脚本和文档的功能。

  • by SimonUTD
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 SimonUTD/mcp2skills

使用说明

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描述）

安装

  1. 安装所需的依赖项：
pip install mcp python-dotenv openai
  1. 安装 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

生成的文件

  1. 技能.md：包含技能元数据、AI生成的描述和使用说明
  2. reference.md：所有可用工具及其模式的详细文档
  3. scripts/[服务器]_wrapper.py：与MCP服务器交互的Python脚本

使用生成的技能

要使用生成的技能，请使用以下命令执行包装器脚本 uv:

uv run --quiet --with mcp /path/to/skill/scripts/server_wrapper.py "tool_name" '{"arg": "value"}'

配置文件检测

该脚本按以下顺序搜索Claude配置文件：

  1. 命令行提供的路径
  2. macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  3. 窗户： %APPDATA%\Claude\claude_desktop_config.json
  4. Linux： ~/.config/Claude/claude_desktop_config.json
  5. 克劳德代码CLI： ~/.claude.json

AI描述生成

当提供API密钥时，脚本使用AI生成技能描述，这些技能描述：

  • 总结技能的能力
  • 确定主要用例
  • 遵循Anthropic的技能描述指南
  • 针对Claude代理路由器兼容性进行了优化

如果AI生成失败，则使用服务器名称和顶级工具创建回退描述。

错误处理

该脚本包括以下全面的错误处理：

  • 缺少配置文件
  • MCP服务器连接失败
  • AI API错误
  • 文件系统权限
  • JSON配置无效

输出

所有生成的技能都放置在 mcp_skills/ 默认情况下为目录。每种技能都是独立的，可以独立使用。

工作流示例

  1. 地方 main.py 在您的项目目录中
  2. 创建一个 .env 使用您的AI API密钥存档
  3. 跑 python main.py
  4. 在中查找生成的技能 mcp_skills/ 目录
  5. 使用提供的技能 uv 命令

故障排除

  • 未找到配置：确保Claude已安装并已配置
  • AI生成失败：在中检查您的API密钥和基本URL .env 文件
  • 包装脚本错误：验证MCP服务器是否正确安装且可访问
  • 权限错误：确保输出目录的写入权限

依赖项

  • mcp：模型上下文协议客户端库
  • openai：与OpenAI兼容的API客户端
  • python-dotenv：环境变量加载
  • pathlib：路径操纵
  • asyncio：异步编程支持

相关 MCP