MCP工具套件

用于MCP服务器集成和Claude Code技能生成的工具套件,包含REST API网关、脚本生成和交互式命令功能。

  • by ulasbilgen
  • TypeScript
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 ulasbilgen/mcp2skill-tools

使用说明

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代码技能

  1. mcp2rest 运行MCP服务器并通过REST API公开工具
  2. mcp2脚本 查询mcp2rest,为每个工具生成JavaScript脚本
  3. 克劳德代码 自动从中发现技能 ~/.claude/skills/ 或 ./.claude/skills/
  4. 生成的脚本调用mcp2rest REST API来执行MCP工具

状态管理

  • 持久状态:由mcp2rest维护(浏览器会话、数据库连接等)
  • 无状态脚本:生成的脚本只进行REST调用
  • 顺序操作:正常工作,因为mcp2rest维护服务器状态

贡献

问题和拉取请求欢迎!

许可证

MIT许可证-请参阅单个软件包许可证文件

相关项目

从Python迁移

如果你正在使用Python mcp2skill 包裹:

  • 新包: mcp2scripts (JavaScript/TypeScript)
  • 生成的脚本:JavaScript(以前是Python)
  • 功能:相同,但使用JavaScript生态系统
  • 迁移指南:参见 包/mcp2scripts/MIGRATION.md