MCP转技能工具

m2s是一个CLI工具,用于将MCP服务器配置转换为轻量级的技能文件,帮助AI代理高效理解和使用MCP服务器。

  • by miownag
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 miownag/mcp-to-skills

使用说明

m2s(MCP到技能)

将MCP服务器转换为技能文件以保存令牌。

这是什么?

m2s是一个CLI工具,它将MCP(模型上下文协议)服务器配置转换为Skill文件。这些技能文件包含轻量级元数据,可帮助AI代理了解何时以及如何使用每个MCP服务器,而无需预先加载完整的MCP配置。

优点:

  • 通过最初仅加载元数据来保存令牌
  • AI代理可以根据元数据决定何时调用MCP
  • 与直接MCP配置效果相同,但效率更高

安装

来自npm

npm install -g mcp-to-skills

从二进制

从发布页面下载适合您平台的二进制文件。

来源

git clone https://github.com/user/mcp-to-skills.git
cd mcp-to-skills
bun install
bun run build

用法

m2s <config-file> [options]

参数

  • config-file -MCP配置文件的路径(Claude Desktop格式)

选项

选项 描述 默认值
-o, --output <dir> 技能文件的输出目录 ./skills
--model <model> 要使用的LLM模型 claude-sonnet-4-5-20250929
--api-key <key> LLM服务的API密钥 M2S_API_KEY 有人是。
--base-url <url> 与OpenAI兼容的API的基本URL M2S_BASE_URL 有人是。
--provider <name> LLM提供者: anthropic 或 openai 自动检测
--timeout <ms> 每个MCP服务器的连接超时 30000
--verbose 启用详细日志记录
--dry-run 无需书写即可预览生成的技能
-h, --help 显示帮助消息
-v, --version 显示版本号

例子

# First, install mcp sdk in your project, skill need this to connect to MCP server
npm install @modelcontextprotocol/sdk

# Basic usage with Anthropic API
m2s ./claude_desktop_config.json --api-key sk-ant-xxx

# Custom output directory
m2s ./config.json -o ./my-skills --api-key sk-ant-xxx

# Using OpenAI-compatible API
m2s ./config.json --base-url https://api.openai.com/v1 --api-key sk-xxx

# Dry run to preview
m2s ./config.json --dry-run --verbose --api-key sk-ant-xxx

输入格式

m2s接受标准的克劳德桌面MCP配置格式:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
      "env": {
        "SOME_VAR": "value"
      }
    },
    "remote-sse": {
      "url": "https://example.com/sse",
      "transport": "sse"
    },
    "remote-ws": {
      "url": "wss://example.com/ws",
      "transport": "websocket"
    },
    "remote-http": {
      "url": "https://example.com/mcp",
      "transport": "streamable-http"
    }
  }
}

输出格式

每个MCP服务器生成一个Markdown技能文件,其中包含:

  • 描述:MCP服务器做什么
  • 何时使用:AI代理的触发条件
  • 能力:提供的具体能力
  • 请求示例:示例用户请求
  • MCP配置:运行时连接的完整配置
  • 可用工具:工具名称、描述和输入模式

支持的交通工具

  • 标准:通过stdin/stdout的本地进程
  • 上海证券交易所:HTTP服务器发送事件
  • WebSocket:WebSocket连接
  • 可流式传输的HTTP:基于HTTP的流传输(MCP 2025-03-26规范)

许可证

麻省理工学院