footnote — MCP-сервер для Claude Code: что делает и как установить
Защищает от выдуманных цифр в отчётах по ERP и финансам, связывая каждое число с реальными строками базы данных.
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env PROVENANCE_DB=<PROVENANCE_DB> --env PROVENANCE_ACTOR=<PROVENANCE_ACTOR> --transport stdio footnote -- npx -y @brick-byte/footnoteЧто делает footnote
Сервер меняет схему работы модели с базой данных: нейросеть не составляет собственный SQL и не считает итоги в уме. Вместо этого агент выбирает типизированную операцию из каталога, а валидация сущностей и вычисления происходят строго на уровне СУБД. Все найденные значения подставляются в слоты готовых шаблонов без права модели переписывать числа.
Каждый сформированный ответ сопровождается неизменяемым журналом аудита. Сервер рассчитывает цепочку хешей для подтверждения подлинности данных и сохраняет идентификаторы строк-источников, поэтому любую цифру можно перепроверить в исходной таблице.
Для запуска необходим Node.js версии 22.5 или выше из-за встроенного модуля node:sqlite. Подключение к внешнему серверу Postgres остаётся опциональным, так как для тестов доступен встроенный демонстрационный набор данных.
Какие задачи решает
- Исключить галлюцинации числовых показателей при генерации финансовых отчётов
- Сформировать проверяемую цепочку источников для аудита ответов ERP-системы
- Заблокировать выполнение произвольного непроверенного SQL со стороны агента
- Предотвратить фальсификацию итогов при пустых выборках из базы
Примеры запросов агенту
- Сколько задолжал клиент Bergmann по просроченным счетам?
- Покажи разбивку по открытым тикетам поддержки с фактами из базы
- Проверь статус оплаты счетов поставщика и покажи строки реестра
Как установить footnote
Командой платформы
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env PROVENANCE_DB=<PROVENANCE_DB> --env PROVENANCE_ACTOR=<PROVENANCE_ACTOR> --transport stdio footnote -- npx -y @brick-byte/footnoteВместо <…> подставьте свои значения
Командой платформы
codex mcp add footnote --env DATABASE_URL=<DATABASE_URL> --env PROVENANCE_DB=<PROVENANCE_DB> --env PROVENANCE_ACTOR=<PROVENANCE_ACTOR> -- npx -y @brick-byte/footnoteВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"footnote": {
"command": "npx",
"args": [
"-y",
"@brick-byte/footnote"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"PROVENANCE_DB": "<PROVENANCE_DB>",
"PROVENANCE_ACTOR": "<PROVENANCE_ACTOR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"footnote": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@brick-byte/footnote"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>",
"PROVENANCE_DB": "<PROVENANCE_DB>",
"PROVENANCE_ACTOR": "<PROVENANCE_ACTOR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e PROVENANCE_DB=<PROVENANCE_DB> -e PROVENANCE_ACTOR=<PROVENANCE_ACTOR> footnote npx -y @brick-byte/footnoteВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о footnote
Как установить footnote в Claude Code?
Выполните команду `claude mcp add --env DATABASE_URL=<DATABASE_URL> --env PROVENANCE_DB=<PROVENANCE_DB> --env PROVENANCE_ACTOR=<PROVENANCE_ACTOR> --transport stdio footnote -- npx -y @brick-byte/footnote` в терминале.
Что делает footnote?
Сервер принудительно направляет запросы к ERP через каталог фиксированных операций, гарантируя вычисление сумм на стороне базы данных и сохранение доказательств происхождения каждого числа.
Обязательно ли настраивать PostgreSQL для запуска?
Внешний Postgres не обязателен. По умолчанию инструмент использует тестовые данные через встроенный движок SQLite в Node 22.5+.
