mcp-turso-cloud

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración con las bases de datos de Turso para los LLM. Este servidor implementa un sistema de autenticación de dos niveles para gestionar operaciones tanto a nivel de organización como de base de datos, lo que facilita la gestión y consulta de las bases de datos de Turso directamente desde los LLM.

Características

Operaciones a nivel de organización

Lista de bases de datos : vea todas las bases de datos en su organización Turso
Crear base de datos : crea nuevas bases de datos con opciones personalizables
Eliminar base de datos : elimine bases de datos de su organización
Generar token de base de datos : crea tokens de autenticación para bases de datos específicas

Operaciones a nivel de base de datos

Lista de tablas : ver todas las tablas en una base de datos específica
Ejecutar consulta de solo lectura : ejecutar consultas SELECT y PRAGMA (operaciones de solo lectura)
Ejecutar consulta : ejecuta consultas SQL potencialmente destructivas (INSERTAR, ACTUALIZAR, ELIMINAR, etc.)
Describir tabla : obtener información del esquema para las tablas de la base de datos
Búsqueda de vectores : realice una búsqueda de similitud de vectores utilizando extensiones de vectores de SQLite

⚠️ IMPORTANTE: Seguridad en la ejecución de consultas ⚠️

Este servidor implementa una separación centrada en la seguridad entre operaciones de base de datos de solo lectura y destructivas:

Utilice execute_read_only_query para consultas SELECT y PRAGMA (operaciones seguras de solo lectura)
Utilice execute_query para INSERTAR, ACTUALIZAR, ELIMINAR, CREAR, ELIMINAR y otras operaciones que modifican datos

Esta separación permite diferentes niveles de permisos y requisitos de aprobación:

Las operaciones de solo lectura se pueden aprobar automáticamente en muchos contextos
Las operaciones destructivas pueden requerir una aprobación explícita por motivos de seguridad.

¡SIEMPRE LEA Y REVISE CUIDADOSAMENTE LAS CONSULTAS SQL ANTES DE APROBARLAS! Esto es especialmente crucial para operaciones destructivas que pueden modificar o eliminar datos. Tómese su tiempo para comprender la función de cada consulta antes de permitir su ejecución.

Sistema de autenticación de dos niveles

El servidor implementa un sofisticado sistema de autenticación:

Autenticación a nivel de organización
- Utiliza un token API de la plataforma Turso
- Administra bases de datos y operaciones a nivel de organización.
- Obtenido a través del panel de Turso
Autenticación a nivel de base de datos
- Utiliza tokens específicos de la base de datos
- Generado automáticamente utilizando el token de la organización
- Almacenado en caché para mejorar el rendimiento y rotado según sea necesario

Configuración

Este servidor requiere configuración a través de su cliente MCP. A continuación, se muestran ejemplos para diferentes entornos:

Configuración de escritorio de Cline/Claude

Agregue esto a su configuración MCP de Cline/Claude Desktop:

{
	"mcpServers": {
		"mcp-turso-cloud": {
			"command": "npx",
			"args": ["-y", "mcp-turso-cloud"],
			"env": {
				"TURSO_API_TOKEN": "your-turso-api-token",
				"TURSO_ORGANIZATION": "your-organization-name",
				"TURSO_DEFAULT_DATABASE": "optional-default-database"
			}
		}
	}
}

Escritorio Claude con configuración WSL

Para entornos WSL, agregue esto a su configuración de Claude Desktop:

{
	"mcpServers": {
		"mcp-turso-cloud": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"TURSO_API_TOKEN=your-token TURSO_ORGANIZATION=your-org node /path/to/mcp-turso-cloud/dist/index.js"
			]
		}
	}
}

Variables de entorno

El servidor requiere las siguientes variables de entorno:

TURSO_API_TOKEN : Su token de API de la plataforma Turso (obligatorio)
TURSO_ORGANIZATION : Nombre de su organización Turso (obligatorio)
TURSO_DEFAULT_DATABASE : Base de datos predeterminada que se utilizará cuando no se especifique ninguna (opcional)
TOKEN_EXPIRATION : Tiempo de expiración de los tokens de base de datos generados (opcional, predeterminado: '7d')
TOKEN_PERMISSION : Nivel de permiso para los tokens generados (opcional, predeterminado: 'acceso completo')

API

El servidor implementa herramientas MCP organizadas por categoría:

Herramientas de organización

lista_bases_de_datos

Enumera todas las bases de datos de su organización Turso.

Parámetros: Ninguno

Ejemplo de respuesta:

{
	"databases": [
		{
			"name": "customer_db",
			"id": "abc123",
			"region": "us-east",
			"created_at": "2023-01-15T12:00:00Z"
		},
		{
			"name": "product_db",
			"id": "def456",
			"region": "eu-west",
			"created_at": "2023-02-20T15:30:00Z"
		}
	]
}

crear_base_de_datos

Crea una nueva base de datos en su organización.

Parámetros:

name (cadena, obligatorio): nombre para la nueva base de datos
group (cadena, opcional): Grupo al que asignar la base de datos
regions (cadena[], opcional): regiones donde se implementará la base de datos

Ejemplo:

{
	"name": "analytics_db",
	"group": "production",
	"regions": ["us-east", "eu-west"]
}

eliminar_base_de_datos

Elimina una base de datos de su organización.

Parámetros:

name (cadena, obligatorio): nombre de la base de datos a eliminar

Ejemplo:

{
	"name": "test_db"
}

generar_token_de_base_de_datos

Genera un nuevo token para una base de datos específica.

Parámetros:

database (cadena, obligatoria): nombre de la base de datos
expiration (cadena, opcional): tiempo de expiración del token
permission (cadena, opcional): nivel de permiso ('acceso completo' o 'solo lectura')

Ejemplo:

{
	"database": "customer_db",
	"expiration": "30d",
	"permission": "read-only"
}

Herramientas de base de datos

listas_de_tablas

Enumera todas las tablas de una base de datos.

Parámetros:

database (cadena, opcional): nombre de la base de datos (usa el contexto si no se proporciona)

Ejemplo:

{
	"database": "customer_db"
}

ejecutar consulta de solo lectura

Ejecuta una consulta SQL de solo lectura (SELECT, PRAGMA) en una base de datos.

Parámetros:

query (cadena, obligatoria): consulta SQL a ejecutar (debe ser SELECT o PRAGMA)
params (objeto, opcional): parámetros de consulta
database (cadena, opcional): nombre de la base de datos (usa el contexto si no se proporciona)

Ejemplo:

{
	"query": "SELECT * FROM users WHERE age > ?",
	"params": { "1": 21 },
	"database": "customer_db"
}

ejecutar_consulta

Ejecuta una consulta SQL potencialmente destructiva (INSERTAR, ACTUALIZAR, ELIMINAR, CREAR, etc.) contra una base de datos.

Parámetros:

query (cadena, obligatoria): consulta SQL a ejecutar (no puede ser SELECT o PRAGMA)
params (objeto, opcional): parámetros de consulta
database (cadena, opcional): nombre de la base de datos (usa el contexto si no se proporciona)

Ejemplo:

{
	"query": "INSERT INTO users (name, age) VALUES (?, ?)",
	"params": { "1": "Alice", "2": 30 },
	"database": "customer_db"
}

describe_tabla

Obtiene información del esquema de una tabla.

Parámetros:

table (cadena, obligatoria): nombre de la tabla
database (cadena, opcional): nombre de la base de datos (usa el contexto si no se proporciona)

Ejemplo:

{
	"table": "users",
	"database": "customer_db"
}

búsqueda_vectorial

Realiza búsquedas de similitud vectorial utilizando extensiones vectoriales SQLite.

Parámetros:

table (cadena, obligatoria): nombre de la tabla
vector_column (cadena, obligatoria): columna que contiene vectores
query_vector (número[], obligatorio): vector de consulta para búsqueda de similitud
limit (número, opcional): Número máximo de resultados (predeterminado: 10)
database (cadena, opcional): nombre de la base de datos (usa el contexto si no se proporciona)

Ejemplo:

{
	"table": "embeddings",
	"vector_column": "embedding",
	"query_vector": [0.1, 0.2, 0.3, 0.4],
	"limit": 5,
	"database": "vector_db"
}

Desarrollo

Configuración

Clonar el repositorio
Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Ejecutar en modo de desarrollo:

npm run dev

Publicación

Actualizar la versión en package.json
Construir el proyecto:

npm run build

Publicar en npm:

npm publish

Solución de problemas

Problemas con el token API

Si encuentra errores de autenticación:

Verifique que su token API de Turso sea válido y tenga los permisos necesarios
Compruebe que el nombre de su organización sea correcto
Asegúrese de que su token no haya expirado

Problemas de conexión a la base de datos

Si tiene problemas para conectarse a las bases de datos:

Verifique que la base de datos exista en su organización
Comprueba que tu token API tenga acceso a la base de datos
Asegúrese de que el nombre de la base de datos esté escrito correctamente

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

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

Expresiones de gratitud

Construido sobre:

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

Related Resources

Reddit Discussion about this server

Related MCP Servers

MongoDB
QuantGeekDev
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.
Last updated -
340
75
TypeScript
MIT License
mcp-lancedb
adiom-data
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables LLMs to interact directly the documents that they have on-disk through agentic RAG and hybrid search in LanceDB. Ask LLMs questions about the dataset as a whole or about specific documents.
Last updated -
12
31
TypeScript
MIT License
MongoDB MCP Server for LLMs
spirita1204
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases, allowing them to query collections, inspect schemas, and manage data seamlessly through natural language.
Last updated -
340
MIT License
Osmosis
jonator
-
security
A
license
-
quality
A Model Context Protocol (MCP) server implementation that enables LLMs to interact with the Osmosis protocol, allowing for querying and transaction functionality through natural language.
Last updated -
9
TypeScript
MIT License

View all related MCP servers

mcp-turso-cloud

Características

Operaciones a nivel de organización

Operaciones a nivel de base de datos

⚠️ IMPORTANTE: Seguridad en la ejecución de consultas ⚠️

Sistema de autenticación de dos niveles

Configuración

Configuración de escritorio de Cline/Claude

Escritorio Claude con configuración WSL

Variables de entorno

API

Herramientas de organización

lista_bases_de_datos

crear_base_de_datos

eliminar_base_de_datos

generar_token_de_base_de_datos

Herramientas de base de datos

listas_de_tablas

ejecutar consulta de solo lectura

ejecutar_consulta

describe_tabla

búsqueda_vectorial

Desarrollo

Configuración

Publicación

Solución de problemas

Problemas con el token API

Problemas de conexión a la base de datos

Contribuyendo

Licencia

Expresiones de gratitud

Tools

Related Resources

Related MCP Servers

MongoDB

mcp-lancedb

MongoDB MCP Server for LLMs

Osmosis

New MCP Servers

MCP directory API