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.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.