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.

Related MCP server: Couchbase MCP Server

Configuración

1. Clonar el repositorio e instalar las dependencias:

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

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

3. Construir el proyecto:

npm run build

4. 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:

1. Instalar dependencias:

npm install
npm run build

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

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