把任何MCP服务器变成技能
概览
mcptoskill 连接任何远程 MCP 服务器,发现其工具,并生成 OpenClaw 或 Hermes 技能——让你只需一个命令,就能将任何兼容 MCP 的服务接入你的 AI 代理环境。 - 通过 npm 安装 -g @filiksyos/mcptoskill 进行全局安装- 通过 npx @filiksyos/mcptoskill 进行无安装 2. 赫尔墨斯特工 — 为赫尔墨斯生成技能(自动发现来自~/.hermes/skills/): 3. 本地 OAuth(Notion,PostHog)——执行命令,遵循以下提示: CLI会打印一个认证URL。在浏览器中打开,完成OAuth,然后从地址栏复制重定向URL(加载失败——没关系),粘贴到终端。令牌保存在本地~/.openclaw/mcptoskill/tokens/。 4. Supabase(本地 OAuth)——与 Notion 相同,无需环境变量: 7. 渲染MCP(API密钥认证)——从Render仪表盘→账户设置→API密钥创建API密钥: — 在远程机器上运行CLI。
概述(AI 翻译)
mcptoskill 连接任何远程 MCP 服务器,发现其工具,并生成 OpenClaw 或 Hermes 技能——让你只需一个命令,就能将任何兼容 MCP 的服务接入你的 AI 代理环境。
CLI 工具
安装——两种变体:
- 通过
npm install -g @filiksyos/mcptoskill进行全局安装 - 通过[[T2]不安装]
用法 — 完整命令签名:
旗帜
| 旗帜 | 描述 |
|---|---|
|
MCP服务器端点URL(必需) |
--target |
输出目标:openclaw(默认)或hermes |
--header "Key: Value" |
添加HTTP头(可重复用于多个头部) |
--skill-key= |
(弃用) mcptoskill.com 的传承技能密钥。改用本地OAuth。 |
--name= |
覆盖自动生成的技能名称 |
--out= |
输出目录(默认:~/.openclaw/skills/ 用于 OpenClaw,~/.hermes/skills/mcptoskill/ 用于 Hermes) |
示例
-
上下文7(无授权):
-
赫尔墨斯特工 — 为赫尔墨斯生成技能(自动发现自
~/.hermes/skills/): -
本地 OAuth(Notion,PostHog)——执行命令,遵循以下提示:
CLI打印一个认证URL。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
mcptoskill
mcptoskill connects to any remote MCP server, discovers its tools, and generates an OpenClaw or Hermes skill — letting you wire any MCP-compatible service into your AI agent environment with a single command.
CLI Tool
Install — two variants:
- Global install via
npm install -g @filiksyos/mcptoskill - No-install via
npx @filiksyos/mcptoskill
Usage — full command signature:
npx @filiksyos/mcptoskill [--target=openclaw|hermes] [--header "Key: Value"] [--name=] [--out=] [--skill-key=]
Flags
| Flag | Description |
|---|---|
| `` | MCP server endpoint URL (required) |
--target |
Output target: openclaw (default) or hermes |
--header "Key: Value" |
Add an HTTP header (repeatable for multiple headers) |
--skill-key= |
(Deprecated) Legacy skill key from mcptoskill.com. Use local OAuth instead. |
--name= |
Override the auto-generated skill name |
--out= |
Output directory (default: ~/.openclaw/skills/ for OpenClaw, ~/.hermes/skills/mcptoskill/ for Hermes) |
Examples
- Context7 (no auth):
npx @filiksyos/mcptoskill https://mcp.context7.com/mcp
- Hermes Agent — generate a skill for Hermes (auto-discovers from
~/.hermes/skills/):
npx @filiksyos/mcptoskill https://mcp.context7.com/mcp --target=hermes
- Local OAuth (Notion, PostHog) — run the command, follow prompts:
npx @filiksyos/mcptoskill https://mcp.notion.com/mcp
The CLI prints an auth URL. Open it in your browser, complete OAuth, then copy the redirect URL from the address bar (it will fail to load — that’s fine) and paste it into the terminal. Tokens are saved locally to ~/.openclaw/mcptoskill/tokens/.
- Supabase (local OAuth) — same flow as Notion, no env vars needed:
npx @filiksyos/mcptoskill https://mcp.supabase.com/mcp
- Supabase (manual Bearer token):
npx @filiksyos/mcptoskill "https://mcp.supabase.com/mcp?project_ref=YOUR_REF" --header "Authorization: Bearer YOUR_TOKEN"
- Exa MCP (key in URL):
npx @filiksyos/mcptoskill "https://mcp.exa.ai/mcp?exaApiKey=YOUR_KEY"
- Render MCP (API key auth) — create an API key from Render Dashboard → Account Settings → API Keys:
npx @filiksyos/mcptoskill https://mcp.render.com/mcp --header "Authorization: Bearer YOUR_RENDER_API_KEY"
VPS / headless — Run the CLI on a remote machine. When prompted, open the auth URL on your laptop, complete OAuth, then copy the redirect URL from the address bar and paste it into the SSH terminal. No server needs to listen on localhost.
What gets generated — two files are created:
SKILL.md— the skill definition with tool documentationscripts/.sh— a shell script that calls the MCP server via curl
Output location depends on --target and --out:
- OpenClaw (default):
~/.openclaw/skills//
推荐工具
换一个关键词,或者移除筛选条件。
安装
npx skillfish add filiksyos/mcptoskill