MCP技能生成工具

mcpskills-cli 是一个将MCP服务器工具转换为代理技能的命令行工具,支持多种脚本语言,适用于需要减少令牌消耗和优化代理性能的场景。

  • by dhanababum
  • Python
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 dhanababum/mcpskills-cli

使用说明

mcpskills cli

从MCP服务器工具生成代理技能。通过Streamable HTTP连接,发现工具,并以您选择的语言输出模式文档和调用脚本的技能。

为什么要把MCP变成技能?

技能易于理解、静态、可编辑,大多数编码和非编码代理都在采用它们。传统的MCP将所有工具加载到上下文中并污染代理;由于加载每个工具,令牌惩罚也很昂贵。这就是为什么我们将MCP转化为技能:技能减少了令牌消耗,因为代理不会将所有技能加载到上下文中——它只在必要时加载它们。

但我们为什么需要MCP?

MCP是AI代理通信的标准化协议。因此,任何系统都可以轻松地采用它,并创建针对其需求的必要工具。

安装

pip install mcpskills-cli
# or for development:
pip install -e .

用法

mcpskills-cli --url <MCP_SERVER_URL> --token <TOKEN> [--name <NAME>] [--output <DIR>] [--script <LANG>] [--multi-skills]
标志 默认值 描述
--url (必需) MCP服务器端点
--token (必填) 不记名代币
--name 来自URL 服务器名称(技能目录+凭据密钥)
--output ~/.cursor/skills 技能输出目录
--script bash 调用脚本语言: bash, python, node, go, rust
--multi-skills false 为每个工具生成单独的技能

例子

# Generate single skill with all tools (default)
mcpskills-cli --url http://localhost:8027/mcp/abc123 --token mytoken --name my-db

# Generate separate skill for each tool
mcpskills-cli --url http://localhost:8027/mcp/abc123 --token mytoken --name my-db --multi-skills

# Generate with Python call script
mcpskills-cli --url http://localhost:8027/mcp/abc123 --token mytoken --name my-db --script python

# Generate with Node.js call script
mcpskills-cli --url http://localhost:8027/mcp/abc123 --token mytoken --name my-db --script node

凭证

存储在 ~/.mcps/credentials (INI格式, chmod 600).每台服务器一个部分,自动更新。

[my-db]
url = http://localhost:8027/mcp/abc123/
token = mytoken

通过直接编辑文件来旋转令牌;无需重新培养技能。

生成的输出

默认模式(单技能)

~/.cursor/skills/<server-name>/
  SKILL.md              # Documents all tools with parameters
  scripts/
    call.<ext>          # Calls any tool: ./call.<ext> <tool_name> '{"key":"val"}'

多技能模式(--多技能)

~/.cursor/skills/<server-name>-<tool-name-1>/
  SKILL.md              # Documents single tool
  scripts/
    call.<ext>          # Calls tool: ./call.<ext> <tool_name> '{"key":"val"}'

~/.cursor/skills/<server-name>-<tool-name-2>/
  SKILL.md
  scripts/
    call.<ext>

需求

  • Python>=3.10
  • fastmcp >= 2.3
  • jinja2 >= 3.1