superskills-mcp

Универсальный шлюз MCP, который предоставляет ваши локальные CLI-навыки любому ИИ-ассистенту. Любой 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"
      }
    }
  ]
}

Описание полей конфигурации

Добавление нового навыка

1. Добавьте новую запись в skills[] в ~/.superskills/mcp-config.json

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"]}

Предоставление доступа для ChatGPT через Ngrok

Ngrok предоставляет бесплатный статический домен, который идеально подходит для постоянных подключений к MCP-серверу. Вы можете получить свой бесплатный статический домен в панели управления Ngrok.

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

Скопируйте URL https://your-free-static-domain.ngrok-free.app/mcp и вставьте его в настройки MCP-коннектора ChatGPT.

4. Подключение к Claude Desktop / Cursor (Stdio-транспорт)

Для локальных MCP-клиентов, таких как Claude Desktop или Cursor, они будут запускать процесс с использованием 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 — отсутствие инъекций оболочки

• Ограничения по времени выполнения и размеру вывода применяются для каждого навыка

• Не открывайте HTTP-транспорт публично без обратного прокси-сервера или уровня аутентификации