shebang-mcp

페이지 호스팅, 파일 공유, 단축 링크 생성, Postgres 데이터베이스 실행, API 키 관리를 모두 단일 shb_… 키로 처리하는 하나의 MCP 서버 및 CLI입니다. shebang.pro 계정용입니다.

빠른 시작

Claude Code:

claude mcp add shebang -- npx -y github:New-Kringster/shebang-mcp
npx -y github:New-Kringster/shebang-mcp login

다른 stdio 기반 MCP 하네스를 사용하는 경우, 이 서버 항목을 추가하세요:

{
  "mcpServers": {
    "shebang": {
      "command": "npx",
      "args": ["-y", "github:New-Kringster/shebang-mcp"]
    }
  }
}

그런 다음 같은 머신의 터미널에서 npx -y github:New-Kringster/shebang-mcp login을 한 번 실행하세요 (또는 SHEBANG_API_KEY를 직접 설정 — 환경 변수 참조).

npm 레지스트리 게시는 계획되어 있지만 아직 라이브가 아닙니다 — 그때까지는 위의 GitHub 약식 표기로 설치하세요.

Related MCP server: Modular MCP Server

로그인 흐름

login은 shebang 플랫폼에 대해 기기 인증 흐름을 시작합니다:

1. CLI가 플랫폼을 호출하여 짧은 코드와 확인 URL을 받아 둘 다 출력합니다 — 그런 다음 브라우저를 해당 URL로 자동으로 열려고 시도합니다.

2. 브라우저에서 shebang.pro 계정에 로그인하고(이미 로그인하지 않은 경우) 터미널에 출력된 것과 동일한 코드와 기기 이름을 보여주는 페이지가 표시됩니다 — 일치하는지 확인한 다음 승인(또는 거부)을 클릭하세요.

3. CLI는 백그라운드에서 폴링하고 있습니다. 승인되면 발급된 키를 ~/.config/shebang/credentials.json(모드 0600)에 쓰고 키의 접두사를 출력합니다.

그 후로는 해당 머신에서 이 서버를 실행하는 모든 하네스가 키를 자동으로 선택합니다 — 프로젝트별 구성이 필요 없습니다.

$ npx -y github:New-Kringster/shebang-mcp login

  Confirm this code in your browser:

    x 7 w y 6 x 3 a

  https://dash.shebang.pro/authorize-agent?code=x7wy6x3a

Opening your browser… (if nothing opens, visit the URL above)
Waiting for approval....
Logged in. Key: shb_examplexxxxxxxx… (master)
Saved to ~/.config/shebang/credentials.json

Your agent can now use shebang.

shebang-mcp status는 현재 키의 접두사와 등급을 표시합니다. shebang-mcp logout은 로컬 자격 증명 파일을 삭제합니다(키를 해지하지는 않습니다 — 아래 참조).

키 등급

• 마스터 — login이 발급하는 키입니다. 계정에 대한 전체 권한: 모든 앱, 그리고 다른 키 발급 및 해지. 로그인당 하나의 마스터 키.

• 앱 — page, serve, link, base의 하위 집합으로 범위가 제한됩니다. key_create_app 도구를 통해 하위 에이전트용으로 하나를 발급하여 필요한 액세스만 갖도록 하세요. 일반 텍스트 키는 응답에서 정확히 한 번만 표시됩니다.

키는 호출을 인증하는 동안 자신을 해지할 수 없습니다 — 다른 키(일반적으로 발급한 마스터 키, key_revoke 도구 사용) 또는 shebang.pro 대시보드의 계정 페이지에서 키를 해지하세요. shebang-mcp logout은 키를 로컬에서만 잊어버립니다. 이 동일한 알림을 출력합니다.

도구 참조

페이지 (sherpage)

파일 (sherserve)

단축 링크 (sherlink)

데이터베이스 (sherbase)

키 (마스터 전용)

OAuth (마스터 전용)

환경 변수

플랫폼

이 저장소의 MCP 서버와 CLI는 클라이언트 전용입니다 — 비밀, 서버 코드, 데이터베이스에 직접 연결하는 것은 없습니다. 플랫폼 자체(계정, 키, 페이지, 파일, 링크, 데이터베이스, OAuth)는 shebang.pro에서 운영됩니다. 이 클라이언트를 사용하려면 해당 계정이 필요합니다.

라이선스

MIT — LICENSE 참조.