Skip to main content
Glama
deenesjakoruzh
Lee2026-dev

superskills-mcp

by Lee2026-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

superskills-mcp

ローカルのCLIスキルをあらゆるAIアシスタントに公開するための汎用MCPゲートウェイ。あらゆる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を開きます。新しいスキルを追加するには、skills配列にJSONブロックを追加します。コードの変更は不要です。

{
  "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 — シェルインジェクションを防止

  • スキルごとにタイムアウトと出力サイズ制限を適用

  • リバースプロキシや認証レイヤーなしで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