remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Turso-hosted LibSQL databases, allowing retrieval of table lists, database schemas, table schemas, and execution of SELECT queries.

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 la 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.

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.

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
- Entrada: - table_name (cadena): Nombre de la tabla a describir
- Devuelve: Matriz de definiciones de columnas con nombres y tipos
query
- Ejecutar una consulta SELECT para leer datos de la base de datos
- Aporte:
  - query (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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que proporciona a Claude acceso a las bases de datos LibSQL alojadas en Turso, lo que permite el listado de tablas de bases de datos, la recuperación de esquemas y la ejecución de consultas SELECT.

Related Resources

Reddit Discussion about this server

MCP-Turso