mcp-l402-gate-example

Минималистичный MCP-сервер, демонстрирующий работу @powforge/mcp-l402-gate.

Один инструмент, bitcoin_data, получает текущую цену BTC/USD и рекомендуемые комиссии в мемпуле с сайта mempool.space. Каждый вызов защищен шлюзом:

1. L402 Lightning-счет (вызывающий платит сатоши за каждый вызов).

2. Проверка оценки Depth-of-Identity (DoI) через публичный оракул PowForge. Если оценка ниже пороговой, оплата не даст доступа.

L402 сам по себе доказывает, что вызывающий заплатил. L402 + DoI доказывает, что они заплатили и обладают репутацией для конкретного открытого ключа, которая сохраняется между сессиями, а для её подделки требуются необратимые затраты ресурсов. Вторая часть — это то, что пропускает большинство комплектов для биллинга MCP.

Быстрый старт

git clone https://github.com/zekebuilds-lab/mcp-l402-gate-example
cd mcp-l402-gate-example
cp .env.example .env       # fill in GATE_HMAC_SECRET and LNBits creds
npm install
npm start

Сервер записывает URL инструмента и оракула в лог при запуске. Порт по умолчанию — 3100.

Related MCP server: l402-kit-mcp

Тестирование с помощью curl

Первый вызов не имеет авторизации, поэтому шлюз возвращает 402 с инвойсом:

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -d '{}'

Ожидаемый ответ:

HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="...", invoice="lnbc1..."
Content-Type: application/json

{
  "error": "payment required",
  "macaroon": "...",
  "invoice": "lnbc1...",
  "payment_hash": "..."
}

Оплатите поле invoice (любым LN-кошельком), получите preimage, а затем повторите попытку:

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -H 'Authorization: L402 <macaroon>:<preimage>' \
  -d '{}'

Вы получите цену BTC, оценки комиссий мемпула и оценку DoI вызывающего абонента.

Манифест также доступен для MCP-клиентов, которые анализируют каталоги инструментов:

curl http://localhost:3100/manifest.json

Конфигурация

Пороговые значения оценки DoI

Это те же категории, которые оракул возвращает как rank. Выберите ту, которая соответствует стоимости ошибочного вызова:

Как работает шлюз

Без шлюза поток 402 + макарун доказывает, что вызывающий заплатил 10 сатоши. Новый кошелек злоумышленника платит те же 10 сатоши. Это нормальный формат передачи данных, но слабая защита от злоупотреблений.

@powforge/mcp-l402-gate сохраняет инвойс L402 и добавляет вторую проверку: когда макарун подтверждается, шлюз вызывает оракул DoI для открытого ключа вызывающего, получает обратно оценку, подписанную Schnorr, и сравнивает её с MIN_SCORE. Оценка складывается из наблюдаемой необратимой работы по четырем измерениям (социальное, доступ, поручительство, экономическое), поэтому новый сибил-аккаунт не сможет накрутить её за минуту.

Полная таблица режимов сбоев находится в README @powforge/mcp-l402-gate.

Файлы

• server.js — MCP-сервер, ~110 строк.

• .env.example — скопируйте в .env и заполните.

• package.json — зависит от express и @powforge/mcp-l402-gate.

Ссылки

• npm: @powforge/mcp-l402-gate

• Документация и цены: powforge.dev/mcp

• Публичный оракул DoI: identity.powforge.dev

Лицензия

MIT.