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 が発行するもの。アカウントに対する完全な権限を持ちます。すべてのアプリに加え、他のキーの発行と失効が可能です。ログインごとに1つのマスターキー。

• アプリ — 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 を参照してください。