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