shebang-mcp

一个 MCP 服务器和 CLI，用于托管页面、共享文件、生成短链接、运行 Postgres 数据库以及管理 API 密钥——全部通过一个 shb_… 密钥，适用于 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 registry 发布已计划但尚未上线——在此之前请通过上面的 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。