Skip to main content
Glama
deenesjakoruzh
Lee2026-dev

superskills-mcp

by Lee2026-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

superskills-mcp

一个通用的 MCP 网关，可将您的本地 CLI 技能暴露给任何 AI 助手。任何 MCP 客户端（ChatGPT、Claude Desktop、Cursor 等）都可以连接到它，并将您的本地脚本作为智能工具调用。

read_x_to_markdown({ url })   ← registered automatically from config
my_custom_skill({ ... })      ← just add to skills array, zero code change

1. 快速入门（全局安装）

在您的系统上全局安装此 CLI 工具：

npm install -g .
# Or via pnpm: pnpm link --global

初始化您的配置文件（创建 ~/.superskills/mcp-config.json）：

superskills-mcp init

启动服务器：

superskills-mcp serve
# To run in the background: superskills-mcp serve &

列出已注册的技能：

superskills-mcp list

停止服务器：

superskills-mcp stop

Related MCP server: local-skills-mcp

2. 注册您的技能

打开 ~/.superskills/mcp-config.json。要添加新技能，请将 JSON 块附加到 skills 数组中 —— 无需更改代码。

{
  "server": {
    "name": "superskills-mcp",
    "version": "0.4.0",
    "transport": "http",
    "host": "127.0.0.1",
    "port": 8787
  },
  "defaults": {
    "timeoutMs": 120000,
    "maxOutputBytes": 10485760,
    "runner": {
      "command": "bun",
      "args": ["{serverDir}/scripts/mcp-adapter.ts"]
    }
  },
  "skills": [
    {
      "name": "read_x_to_markdown",
      "description": "Read a given X/Twitter link and return clean Markdown.",
      "skillDir": "/Users/wenli/.baoyu-skills/skills/baoyu-danger-x-to-markdown",
      "input": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "X/Twitter post URL to read"
        }
      },
      "env": {
        "BAOYU_X_TO_MARKDOWN_DOWNLOAD_MEDIA": "true",
        "BAOYU_X_TO_MARKDOWN_KEEP_OUTPUT": "false"
      }
    }
  ]
}

配置字段说明

字段

说明

server.name

显示给 MCP 客户端的服务器名称

server.transport

"http"（用于 ChatGPT / 远程）或 "stdio"（用于本地客户端）

defaults.runner.args

{serverDir} 会自动替换为该项目的绝对安装路径

skills[].skillDir

您本地技能目录的绝对路径

skills[].input

输入模式 —— 每个字段都会成为经过验证的 MCP 工具参数

skills[].env

转发给适配器的环境变量

添加新技能

  1. 在 ~/.superskills/mcp-config.json 的 skills[] 中添加一个新条目

  2. 重启服务器 (superskills-mcp serve)

  3. 新工具将自动提供给所有已连接的 MCP 客户端

3. 连接到 ChatGPT (HTTP 传输)

对于 ChatGPT 或任何远程 MCP 客户端，服务器必须以 HTTP 模式运行（这是默认模式）。

superskills-mcp serve

验证它是否正在运行：

curl http://127.0.0.1:8787/health
# → {"ok":true,"name":"superskills-mcp","version":"0.4.0","tools":["read_x_to_markdown"]}

通过 Ngrok 暴露给 ChatGPT

Ngrok 提供了一个免费的静态域名，非常适合持久的 MCP 服务器连接。您可以从 Ngrok 仪表板获取免费的静态域名。

ngrok http --domain=your-free-static-domain.ngrok-free.app 8787

复制 URL https://your-free-static-domain.ngrok-free.app/mcp 并将其粘贴到 ChatGPT 的 MCP 连接器设置中。

4. 连接到 Claude Desktop / Cursor (Stdio 传输)

对于 Claude Desktop 或 Cursor 等本地 MCP 客户端，它们将使用 stdio 启动进程。

Claude Desktop 配置示例 (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "superskills-mcp": {
      "command": "superskills-mcp",
      "args": ["serve", "--transport", "stdio"]
    }
  }
}

5. 安全性

  • skillDir 必须存在且为一个目录（在启动时验证）

  • 运行脚本必须位于 serverDir（内置适配器）或 skillDir（技能自身的脚本）内

  • shell: false —— 无 shell 注入

  • 每个技能都强制执行超时和输出大小限制

  • 在没有反向代理或身份验证层的情况下，请勿公开暴露 HTTP 传输

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers