Servidor MCP de Couchbase

El Protocolo de Contexto de Modelo (MCP) gestiona las interacciones entre grandes modelos de lenguaje (LLM) y sistemas externos. Este repositorio implementa un servidor MCP de Couchbase mediante el SDK de Couchbase Node.js, lo que permite a los clientes MCP (p. ej., Claude Desktop) realizar consultas en lenguaje natural en clústeres de Couchbase Capella.

Con este servidor puedes utilizar comandos como:

Show me the results of SELECT * FROM my_bucket LIMIT 10
Execute this query: SELECT name, age FROM users WHERE active = true
Get me the latest 5 documents from my_bucket
Summarize the latest 5 orders from the orders bucket for me

Ejemplo

La siguiente captura de pantalla muestra el servidor MCP en funcionamiento con el cliente Claude Desktop. El usuario emite una solicitud general en lenguaje sencillo y el servidor MCP la traduce a una consulta SQL++ que se ejecuta en el clúster Couchbase Capella. Los resultados se devuelven al usuario en un formato legible.

Configuración

Clonar el repositorio e instalar las dependencias:

git clone git@github.com:hummusonrails/couchbase-mcp-server.git
cd couchbase-mcp-server
npm install

Cree un archivo .env en el directorio raíz y agregue su cadena de conexión de Couchbase, nombre de usuario y contraseña:

COUCHBASE_CONNECTION_STRING=couchbases://your-cluster.cloud.couchbase.com
COUCHBASE_USERNAME=your_username
COUCHBASE_PASSWORD=your_password

Consulte el archivo .env.sample para conocer las variables de entorno requeridas.

Construir el proyecto:

npm run build

Ejecute el servidor utilizando el transporte Stdio:

npx couchbase-mcp-server

[!NOTA] El servidor MCP utiliza StdioServerTransport, por lo que se comunica mediante E/S estándar. Asegúrese de que su cliente MCP (p. ej., Claude Desktop) esté configurado para usar un servidor MCP local. Consulte la documentación de Claude Desktop para configurar el cliente MCP para que se conecte al servidor local.

Características

Herramienta de consulta de Couchbase

Nombre de la herramienta: query-couchbase
Descripción: Ejecuta una declaración de consulta SQL++ en su clúster Couchbase Capella.
Uso : cuando se invoca, el servidor utilizará el SDK Couchbase Node.js para ejecutar la consulta SQL++ proporcionada y devolver los resultados.

Desarrollo

Para trabajar en el proyecto localmente:

Instalar dependencias:

npm install
npm run build

Pruebe el servidor usando un cliente MCP:

Inicie su cliente MCP (por ejemplo, Claude Desktop) configurado para conectarse e invocar la herramienta utilizando una consulta de muestra.

Depuración

Todos los mensajes de registro se envían a stderr para garantizar que stdout solo contenga el JSON del protocolo MCP. Revise sus registros para obtener información detallada sobre la conexión y los mensajes de error.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios o abrir un problema con sus sugerencias. Para cualquier cambio, asegúrese de seguir el estilo de código del proyecto.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

Un servidor que permite interacciones en lenguaje natural con bases de datos de Couchbase a través del Protocolo de Contexto de Modelo, permitiendo a los usuarios realizar consultas SQL++ en clústeres Couchbase Capella utilizando comandos conversacionales.

Related MCP Servers

Supabase MCP Server
Cappahccino
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude and other LLMs to perform database operations and invoke Edge Functions within Supabase through natural language.
Last updated -
574
3
TypeScript
MIT License
Couchbase MCP Server for LLMs
Aniket310101
-
security
F
license
-
quality
A Model Context Protocol server that enables large language models to interact directly with Couchbase databases through natural language, supporting operations like querying buckets, performing CRUD operations, and executing N1QL queries.
Last updated -
7
7
TypeScript
MCP SQL Server
JubinSaniei
-
security
F
license
-
quality
A Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.
Last updated -
TypeScript
Couchbase MCP Server
Couchbase-Ecosystem
A
security
A
license
A
quality
mcp-server-couchbase
Last updated -
8
16
Python
Apache 2.0

View all related MCP servers

Couchbase MCP Server