mcp-turso

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a las bases de datos LibSQL alojadas en Turso. Actualmente, el servidor ofrece las siguientes funciones:

• Recuperar una lista de tablas en una base de datos

• Recuperar el esquema de una base de datos

• Recuperando el esquema de una tabla

• Realizar consultas SELECT

Configuración

Con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "mcp-turso"],
         "env": {
            "TURSO_DATABASE_URL": "your_url",
            "TURSO_AUTH_TOKEN": "your_token"
         }
      }
   ]
}

Necesitará una base de datos existente para continuar. Si no tiene una, créela . Para obtener la URL de la base de datos mediante la CLI de Turso, ejecute:

turso db show --url <database-name>

Luego obtenga el token de autenticación de la base de datos:

turso db tokens create <database-name>

Agregue esos valores a su configuración como se muestra arriba.

Con el cursor

Para configurar el servidor Turso MCP con Cursor, agregue lo siguiente a la configuración de Cursor:

1. Abra Cursor y vaya a Configuración (⚙️) > Configuración (JSON)

2. Añade la siguiente configuración a tu JSON de configuración:

"mcpServers": {
  "turso": {
    "command": "npx",
    "args": ["-y", "mcp-turso"],
    "env": {
      "TURSO_DATABASE_URL": "your_url",
      "TURSO_AUTH_TOKEN": "your_token"
    }
  }
}

Reemplace your_url y your_token con la URL de su base de datos de Turso y el token de autenticación como se describe en la sección anterior.

Explotación florestal

El servidor incluye un registrador personalizado para la depuración fuera de Claude Desktop. De forma predeterminada, este registrador escribe en <parent-dir>/logs/mcp-turso.log , donde <parent-dir> es el directorio principal del directorio que contiene el script mcp-turso . En otras palabras, si la ruta a mcp-turso es ~/foo/bin/mcp-turso , los registros estarán en ~/foo/logs/mcp-turso.log . Si se ejecuta con NPX como se indicó anteriormente, los registros predeterminados serán:

~/.npm/_npx/<npx-dir-name>/node_modules/mcp-turso/logs/mcp-turso.log

Si desea especificar una ruta personalizada, puede incluir un indicador --logs con una ruta posix absoluta en la configuración del servidor:

{
   "mcpServers": [
      "turso": {
         "command": "npx",
         "args": ["-y", "mcp-turso", "--logs", "/Users/<username>/path/to/dir/mcp-logs.log"],
         "env": {
            "TURSO_DATABASE_URL": "your_url",
            "TURSO_AUTH_TOKEN": "your_token"
         }
      }
   ]
}

La ruta al archivo de registro (predeterminada o personalizada) siempre se registra en stderr al crear el servidor. En el caso de Claude Desktop, esto aparecerá en los registros del servidor en ~/Library/Logs/Claude .

Nota : En este momento no he implementado la especificación de un archivo de registro personalizado para Windows, pero esto está por venir.

Related MCP server: Supabase MCP Server

Capacidades del servidor

El servidor proporciona las siguientes herramientas:

• list_tables

  • Obtener una lista de todas las tablas de la base de datos

  • Sin entrada

  • Devuelve: una matriz de nombres de tablas

• get_db_schema

  • Obtener los esquemas de todas las tablas de la base de datos

  • Sin entrada

  • Devuelve: una matriz de declaraciones de creación de SQL

• describe_table

  • Ver información del esquema para una tabla específica

  • Aporte:

    • table_name (cadena): Nombre de la tabla a describir

  • Devuelve: Matriz de definiciones de columnas con nombres y tipos

• query_database

  • Ejecutar una consulta SELECT para leer datos de la base de datos

  • Aporte:

    • sql (cadena): La consulta SQL SELECT que se ejecutará

  • Devuelve: Los resultados de la consulta son un objeto de tipo { columns: string[]; rows: Record<string, unknown>[]; rowCount: number; }

Hacer

• [ ] Agregue la capacidad de especificar un archivo de registro personalizado en Windows

• [ ] Agregar más herramientas de consulta

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.