superskills-mcp

Ein universelles MCP-Gateway, das Ihre lokalen CLI-Skills für jeden KI-Assistenten verfügbar macht. Jeder MCP-Client (ChatGPT, Claude Desktop, Cursor usw.) kann sich damit verbinden und Ihre lokalen Skripte als intelligente Tools aufrufen.

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

1. Schnellstart (Globale Installation)

Installieren Sie das CLI-Tool global auf Ihrem System:

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

Initialisieren Sie Ihre Konfigurationsdatei (erstellt ~/.superskills/mcp-config.json):

superskills-mcp init

Starten Sie den Server:

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

Listen Sie registrierte Skills auf:

superskills-mcp list

Stoppen Sie den Server:

superskills-mcp stop

Related MCP server: local-skills-mcp

2. Registrieren Sie Ihre Skills

Öffnen Sie ~/.superskills/mcp-config.json. Um einen neuen Skill hinzuzufügen, fügen Sie einen JSON-Block zum skills-Array hinzu — keine Codeänderungen erforderlich.

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

Erläuterung der Konfigurationsfelder

Hinzufügen eines neuen Skills

1. Fügen Sie einen neuen Eintrag zu skills[] in ~/.superskills/mcp-config.json hinzu

2. Starten Sie den Server neu (superskills-mcp serve)

3. Das neue Tool ist automatisch für alle verbundenen MCP-Clients verfügbar

3. Verbindung zu ChatGPT (HTTP-Transport)

Für ChatGPT oder jeden Remote-MCP-Client muss der Server im HTTP-Modus laufen (dies ist der Standard).

superskills-mcp serve

Überprüfen Sie, ob er läuft:

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

Bereitstellung für ChatGPT über Ngrok

Ngrok bietet eine kostenlose statische Domain, die ideal für dauerhafte MCP-Serververbindungen ist. Sie erhalten Ihre kostenlose statische Domain über Ihr Ngrok-Dashboard.

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

Kopieren Sie die URL https://your-free-static-domain.ngrok-free.app/mcp und fügen Sie sie in die MCP-Connector-Einstellungen von ChatGPT ein.

4. Verbindung zu Claude Desktop / Cursor (Stdio-Transport)

Lokale MCP-Clients wie Claude Desktop oder Cursor starten den Prozess über stdio.

Beispiel für die Claude Desktop-Konfiguration (~/Library/Application Support/Claude/claude_desktop_config.json):

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

5. Sicherheit

• skillDir muss existieren und ein Verzeichnis sein (wird beim Start validiert)

• Runner-Skripte müssen sich innerhalb von serverDir (integrierter Adapter) oder skillDir (eigene Skripte des Skills) befinden

• shell: false — keine Shell-Injection

• Zeitüberschreitungs- und Ausgabegrößenbeschränkungen werden pro Skill durchgesetzt

• Setzen Sie den HTTP-Transport nicht ohne Reverse Proxy oder Authentifizierungsebene öffentlich aus