# mcp-turso-cloud

Подключает Claude Code и другие MCP-клиенты к Turso: агент сможет управлять базами, выполнять SQL и искать векторные совпадения.

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

## Что делает

mcp-turso-cloud связывает MCP-клиент с Turso. Агент может получать список баз организации, создавать и удалять базы, выпускать токены, просматривать таблицы и схему. Для SQL предусмотрены чтение, запись и векторный поиск через расширения SQLite.

Сервер разделяет доступ на организационный и базовый уровень. Для чтения он запрашивает read-only-токен, а операции INSERT, UPDATE, DELETE, CREATE и DROP отправляет через инструмент записи. Локальная проверка отклоняет несколько SQL-операций в одном запросе, изменяющие PRAGMA и файловые или расширяющие функции.

Перед запуском нужны `TURSO_API_TOKEN` и `TURSO_ORGANIZATION`; без них сервер не подключится. `TURSO_DEFAULT_DATABASE`, `TOKEN_EXPIRATION` и `TOKEN_PERMISSION` можно передать как дополнительные переменные окружения.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `TURSO_API_TOKEN`, `TURSO_ORGANIZATION`, `TURSO_DEFAULT_DATABASE`, `TOKEN_EXPIRATION`, `TOKEN_PERMISSION` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env TURSO_API_TOKEN=<TURSO_API_TOKEN> --env TURSO_ORGANIZATION=<TURSO_ORGANIZATION> --env TURSO_DEFAULT_DATABASE=<TURSO_DEFAULT_DATABASE> --env TOKEN_EXPIRATION=<TOKEN_EXPIRATION> --env TOKEN_PERMISSION=<TOKEN_PERMISSION> --transport stdio mcp-turso-cloud -- npx -y mcp-turso-cloud
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-turso-cloud --env TURSO_API_TOKEN=<TURSO_API_TOKEN> --env TURSO_ORGANIZATION=<TURSO_ORGANIZATION> --env TURSO_DEFAULT_DATABASE=<TURSO_DEFAULT_DATABASE> --env TOKEN_EXPIRATION=<TOKEN_EXPIRATION> --env TOKEN_PERMISSION=<TOKEN_PERMISSION> -- npx -y mcp-turso-cloud
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-turso-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-turso-cloud"
            ],
            "env": {
                "TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
                "TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
                "TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>",
                "TOKEN_EXPIRATION": "<TOKEN_EXPIRATION>",
                "TOKEN_PERMISSION": "<TOKEN_PERMISSION>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-turso-cloud": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-turso-cloud"
            ],
            "env": {
                "TURSO_API_TOKEN": "<TURSO_API_TOKEN>",
                "TURSO_ORGANIZATION": "<TURSO_ORGANIZATION>",
                "TURSO_DEFAULT_DATABASE": "<TURSO_DEFAULT_DATABASE>",
                "TOKEN_EXPIRATION": "<TOKEN_EXPIRATION>",
                "TOKEN_PERMISSION": "<TOKEN_PERMISSION>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TURSO_API_TOKEN=<TURSO_API_TOKEN> -e TURSO_ORGANIZATION=<TURSO_ORGANIZATION> -e TURSO_DEFAULT_DATABASE=<TURSO_DEFAULT_DATABASE> -e TOKEN_EXPIRATION=<TOKEN_EXPIRATION> -e TOKEN_PERMISSION=<TOKEN_PERMISSION> mcp-turso-cloud npx -y mcp-turso-cloud
```
Вместо <…> подставьте свои значения

## Когда брать
- просматривать базы в организации Turso
- создавать и удалять базы данных
- выполнять SELECT-запросы с read-only-доступом
- изменять данные через SQL после подтверждения
- получать схему таблиц и искать похожие векторы

## Примеры запросов агенту
- Покажи все базы в организации Turso и их параметры.
- Выполни безопасный SELECT в базе `customer_db` и опиши результат.
- Проверь SQL перед изменением данных в базе и выполни запрос только после моего подтверждения.

## Похожие
- [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