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

Любой другой MCP-хост на основе stdio, добавьте эту запись сервера:

{
  "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 (если ещё не вошли) и видите страницу с именем устройства и тем же кодом, который вывел терминал, — убедитесь, что они совпадают, и нажмите Approve (или Deny).

3. CLI всё это время опрашивает сервер в фоне; после подтверждения он записывает выданный ключ в ~/.config/shebang/credentials.json (режим 0600) и выводит префикс ключа.

После этого любой MCP-хост на этой машине, запускающий этот сервер, автоматически подхватывает ключ — никакой настройки для каждого проекта не требуется.

$ 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 удаляет локальный файл учётных данных (но не отзывает ключ — см. ниже).

Уровни ключей

• Master — то, что выпускает login. Полные права на аккаунт: все приложения, а также выпуск и отзыв других ключей. Один мастер-ключ на один вход.

• App — ограничен подмножеством page, serve, link, base. Выпустите такой ключ для субагента через инструмент key_create_app, чтобы он получил только нужный доступ; открытый текст ключа показывается в ответе ровно один раз.

Ключ не может отозвать сам себя, пока именно он аутентифицирует вызов, — отзывайте ключ другим ключом (обычно мастер-ключом, который его выпустил, через инструмент key_revoke) или со страницы аккаунта в панели shebang.pro. shebang-mcp logout лишь забывает ключ локально; он выводит то же напоминание.

Справочник инструментов

Страницы (sherpage)

Файлы (sherserve)

Короткие ссылки (sherlink)

Базы данных (sherbase)

Ключи (только master)

OAuth (только master)

Переменные окружения

Платформа

MCP-сервер и CLI из этого репозитория — это только клиент: никаких секретов, никакого серверного кода, ничего, что напрямую обращается к базе данных. Сама платформа (аккаунты, ключи, страницы, файлы, ссылки, базы данных, OAuth) работает на shebang.pro; для использования этого клиента требуется аккаунт там.

Лицензия

MIT — см. LICENSE.