mcp2skill工具
MCP(模型上下文协议)工具套件的Monrepo。
包裹
此monorepo包含三个包,它们协同工作以实现MCP服务器与Claude Code的集成:
📦 mcp2rest
用于MCP服务器的REST API网关。将MCP服务器作为持久进程运行,并通过REST API公开其工具。
- 目的:使用HTTP访问运行和管理MCP服务器
- 主要特点:服务器生命周期管理,REST API端点,持久状态
- 默认端口: 28888
- 状态:生产就绪
📦 mcp2脚本
从MCP服务器工具生成JavaScript脚本,供Claude Code Skills使用。
- 目的:将MCP工具转换为可执行脚本
- 主要特点:自动生成JavaScript包装器、基于命令的CLI、技能文档
- 生成的脚本:JavaScript(Node.js)
- 状态:生产就绪(Python mcp2skill的TypeScript重写)
📦 mcp2skill命令
Claude Code斜线命令用于交互式技能生成和管理。
- 目的:交互式技能创建工作流程
- 主要特点:
/m2s:init,/m2s:generate,/m2s:update,/m2s:list,/m2s:add - 包含:技能创作最佳实践指南
- 状态:生产就绪
快速开始
# Install all dependencies
npm install
# Build all packages
npm run build
# Run tests
npm run test工作流程
┌─────────────┐
│ mcp2rest │ ← Manages MCP servers, exposes REST API
└──────┬──────┘
│
▼
┌─────────────┐
│ mcp2scripts │ ← Generates JavaScript scripts from MCP tools
└──────┬──────┘
│
▼
┌─────────────┐
│Claude Code │ ← Uses generated skills automatically
│ Skills │
└─────────────┘安装
每个软件包都可以独立安装:
# mcp2rest - Install globally to run MCP servers
npm install -g mcp2rest
# mcp2scripts - Install globally to generate skills
npm install -g mcp2scripts
# mcp2skill-commands - Install in Claude Code project
# Copy .claude/commands/m2s/ to your project发展
先决条件
- Node.js>=18.0.0
- npm>=9.0.0
设置
# Clone the repository
git clone https://github.com/ulasbilgen/mcp2skill-tools.git
cd mcp2skill-tools
# Install dependencies for all packages
npm install
# Build all packages
npm run build使用软件包
每个包都可以独立开发:
# Work on mcp2rest
cd packages/mcp2rest
npm run dev
# Work on mcp2scripts
cd packages/mcp2scripts
npm run dev
# Test a specific package
cd packages/mcp2scripts
npm test建筑
mcp2rest→ mcp2脚本→ Claude代码技能
- mcp2rest 运行MCP服务器并通过REST API公开工具
- mcp2脚本 查询mcp2rest,为每个工具生成JavaScript脚本
- 克劳德代码 自动从中发现技能
~/.claude/skills/或./.claude/skills/ - 生成的脚本调用mcp2rest REST API来执行MCP工具
状态管理
- 持久状态:由mcp2rest维护(浏览器会话、数据库连接等)
- 无状态脚本:生成的脚本只进行REST调用
- 顺序操作:正常工作,因为mcp2rest维护服务器状态
贡献
问题和拉取请求欢迎!
许可证
MIT许可证-请参阅单个软件包许可证文件
相关项目
- 模型上下文协议 -MCP规范
- 克劳德代码 -具有技能支持的AI编码助手
- mcp2skill(Python) -原始Python实现(已弃用)
从Python迁移
如果你正在使用Python mcp2skill 包裹:
- 新包:
mcp2scripts(JavaScript/TypeScript) - 生成的脚本:JavaScript(以前是Python)
- 功能:相同,但使用JavaScript生态系统
- 迁移指南:参见 包/mcp2scripts/MIGRATION.md
