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

A

license - permissive license

-

quality - not tested

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.

Couchbase MCP Server

Integrations