Skip to main content
Glama
deenesjakoruzh
Lee2026-dev

superskills-mcp

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