mcp-turso

Source

🗂️ A Model Context Protocol (MCP) server that provides integration with Turso databases for LLMs. This server implements a two-level authentication system to handle both organization-level and database-level operations, making it easy to manage and query Turso databases directly from LLMs.

Catalog onlyCatalog onlySTDIO

Overview

mcp-turso is a Model Context Protocol (MCP) server that integrates with Turso databases for large language models (LLMs), providing a two-level authentication system for managing and querying databases.

To use mcp-turso, configure your MCP client with the required environment variables and run the server. You can perform operations like listing databases, creating new databases, and executing SQL queries.

Organization-level operations for managing databases - Database-level operations for executing queries and managing tables - Two-level authentication system for secure access - Vector similarity search capabilities using SQLite extensions

Managing multiple databases for an organization
Executing complex SQL queries for data analysis
Performing vector searches for machine learning applications

Add to your AI client

Use these steps to connect mcp-turso in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-turso-spences10": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-turso-spences10": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-turso-spences10": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-turso-spences10": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-turso-spences10": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-turso-spences10": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-turso-spences10"
      ]
    }
  }
}

FAQ

What is the purpose of the two-level authentication system?

It ensures secure access at both the organization and database levels, allowing for better management of resources.

Can I use mcp-turso with any database?

mcp-turso is specifically designed for Turso databases.

Is there a limit to the number of databases I can create?

No, you can create as many databases as your organization needs, subject to Turso's resource limits.

Developer tools