Faucet

Faucet — MCP-сервер сообщества (автор — faucetdb). SQL-базы как инструменты MCP и REST API: PostgreSQL, MySQL, SQL Server, Oracle и SQLite. Ставится через npx или через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
faucetdb
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
api_key
ОС
Не указана
Языки
go

Уровень риска: high

Читает и изменяет данные в базах, администратор может выполнять произвольный SQL; доступ ограничивается ролью ключа API.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"faucet\": {\n      \"url\": \"http://localhost:8080/mcp\",\n      \"headers\": { \"X-API-Key\": \"YOUR_API_KEY\" }\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Или .cursor/mcp.json",
    "verified": "docs"
}

Что умеет

Faucet — открытый (MIT) сервер в виде одного бинарника на Go, который превращает базу данных PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, Snowflake или SQLite в REST API и MCP-сервер для ИИ-агентов. Эндпоинты, спецификация OpenAPI 3.1 и инструменты MCP генерируются из схемы базы во время работы — без генерации кода и ORM. Есть ролевая модель доступа (RBAC) и встроенная веб-админка.

Инструменты MCP:

Инструмент Назначение
faucet_list_services Список подключённых баз
faucet_list_tables Таблицы базы
faucet_describe_table Колонки, типы и ограничения
faucet_query Выборка с фильтрами, сортировкой и пагинацией
faucet_insert Вставка записей
faucet_update Изменение записей
faucet_delete Удаление записей
faucet_raw_sql Произвольный SQL (только для администратора)

Сервер MCP работает по адресу http://localhost:8080/mcp (Streamable HTTP) на том же порту, что и REST API. Агент авторизуется ключом API в заголовке X-API-Key, а роль ключа определяет, какие базы и таблицы он видит и может менять, — точно как в REST API. Ключи хранятся в виде хэшей SHA-256, права задаются по таблицам и HTTP-методам. Страница «AI agents (MCP)» в админке сама генерирует конфиги с подставленным ключом.

Кому подойдёт

  • Командам, которые хотят дать агенту управляемый доступ к базе — на чтение или запись, с ролями.
  • Разработчикам внутренних инструментов: REST API поверх существующей базы без изменения инфраструктуры.
  • Владельцам старых баз: API перед SQL Server 2012, MySQL 5.7 или PostgreSQL 9.6 без правок кода.

Похожие серверы — в категории базы данных.

Установка

Быстрый старт через npm (Node.js 18+): npx @faucetdb/faucet serve. Также есть Homebrew (brew install faucetdb/tap/faucet), Go, готовые бинарники и Docker-образ faucetdb/faucet. Базы подключаются в админке или командой faucet db add, ключ создаётся командой faucet key create. Собственная конфигурация Faucet хранится во встроенном файле SQLite, строки из ваших баз никуда не копируются.

Подключение к клиентам

Конфиги приведены дословно из README. Замените YOUR_API_KEY ключом со страницы API keys. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http faucet http://localhost:8080/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor читает ~/.cursor/mcp.json или .cursor/mcp.json, VS Code — .vscode/mcp.json (Copilot Chat в режиме агента). Для Windsurf (~/.codeium/windsurf/mcp_config.json) используйте конфиг Cursor с ключом serverUrl вместо url. Claude Desktop запускает только локальные команды, поэтому подключается через мост mcp-remote в claude_desktop_config.json; для удалённого сервера по http добавьте аргумент --allow-http.

Проверка

Попросите агента вызвать faucet_list_services и перечислить таблицы одной из баз.

Примеры задач

Покажи 10 последних заказов со статусом «новый» из базы shop.
Опиши структуру таблицы customers и найди клиентов без email.

Риски

  • Запись в базу. Инструменты вставляют, меняют и удаляют записи, а администратор может выполнять произвольный SQL. Выдайте агенту ключ с ролью только на чтение или с правами на нужные таблицы.
  • Локальный stdio-режим (npx -y @faucetdb/faucet mcp) работает с правами локального администратора, роли не применяются — используйте его только на своей машине.
  • Ключи и пароли. Ключ API и данные подключения к базам храните в секрете.
  • Фильтры на уровне строк пока только сохраняются и не применяются к запросам — не полагайтесь на них для разграничения доступа.

Частые вопросы

Чем Faucet отличается от PostgREST или Hasura?

Поддерживает несколько СУБД, имеет встроенную админку и MCP-сервер в одном бинарнике.

Можно ли подключить ChatGPT?

Коннекторы ChatGPT требуют OAuth, которого в Faucet нет; README предлагает Custom GPT Action со спецификацией OpenAPI.

Где хранятся данные?

В ваших базах: Faucet обращается к ним напрямую и не копирует строки.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники