# csvql

Даёт агенту читать CSV через SQL прямо на месте: без импорта, без отдельной базы и без записи в файлы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 30
- Автор: melihbirim
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/melihbirim/csvql
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/csvql

## Что делает

Сервер поднимает три инструмента: `csv_query` принимает SQL, `csv_schema` отдаёт колонки и несколько строк примера, `csv_list` перечисляет CSV в каталоге. Запрос идёт по файлу там, где он лежит, так что импортировать ничего не нужно. Внутри один статический бинарник на Zig, сетевого кода в нём нет. Выдача обрезана примерно до 100 строк и 12 KB, поэтому случайный `SELECT *` не зальёт контекст.

Ставится одной командой `csvql install`: она прописывает сервер в Claude Code и чужие записи в конфиге не трогает. Дальше Claude Code надо перезапустить. Для VS Code с Copilot те же `command` и `args` кладут в `.vscode/mcp.json` под ключ `servers`, указав тип `stdio`; на удалённой машине сервер запускают через `ssh`, и наружу уходят только SQL и мелкий ответ.

SQL здесь урезанный: нет `UNION` и оконных функций, внешних join тоже нет, подзапрос работает только в виде `col IN (SELECT ...)`. Такие запросы падают с ошибкой, а не возвращают неверные строки. На входе только CSV. Если до сервера может дотянуться кто-то ещё, `--root` обязателен: с `--root /data` выход за каталог отбивается ошибкой `PathOutsideAllowedRoot`.

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- посчитать выручку по клиентам из `sales.csv`, не загружая файл в базу
- посмотреть колонки незнакомого CSV перед тем, как писать запрос
- узнать, какие CSV лежат в каталоге `/data`
- ответить на вопрос по файлу на 8 GB, не выгружая его в контекст
- прогнать SQL по данным на сервере через `ssh`, не открывая порт

## Примеры запросов агенту
- Посчитай через csvql, сколько заказов у каждого клиента в `orders.csv`, и покажи первые 10 строк.
- Сначала посмотри схему `trips.csv`, потом сгруппируй строки по `cab_type`.
- Покажи через `csv_list`, какие CSV есть в `/data`.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27669
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49845

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md