Skip to main content
Glama
deenesjakoruzh
Lee2026-dev

superskills-mcp

by Lee2026-dev
OverviewSchemaRelated ServersScoreDiscussions
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 installed

A
license - permissive license
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • anythingmcp

    Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

  • Kody

    Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • shortcuts-bridge

    MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lee2026-dev/superskills-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server