servidor greptimedb-mcp

Name: GreptimeDB MCP Server
Author: GreptimeTeam

PyPI - Versión flujo de trabajo de construcción Licencia MIT

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para GreptimeDB .

Este servidor proporciona a los asistentes de IA una forma segura y estructurada de explorar y analizar bases de datos. Les permite listar tablas, leer datos y ejecutar consultas SQL a través de una interfaz controlada, lo que garantiza un acceso responsable a la base de datos.

Estado del proyecto

Este es un proyecto experimental en desarrollo. No se han abordado específicamente los problemas de seguridad y privacidad de los datos, por lo que se recomienda usarlo con precaución.

Capacidades

list_resources para listar tablas
read_resource para leer datos de la tabla
list_tools para enumerar herramientas
call_tool para ejecutar un SQL
list_prompts para enumerar las indicaciones
get_prompt para obtener el mensaje por nombre

Instalación

pip install greptimedb-mcp-server

Configuración

Establezca las siguientes variables de entorno:

GREPTIMEDB_HOST=localhost # Database host GREPTIMEDB_PORT=4002 # Optional: Database MySQL port (defaults to 4002 if not specified) GREPTIMEDB_USER=root GREPTIMEDB_PASSWORD= GREPTIMEDB_DATABASE=public

O mediante argumentos de línea de comandos:

--host el host de la base de datos, localhost por defecto,
--port el puerto de la base de datos, debe ser el puerto del protocolo MySQL, 4002 por defecto,
--user el nombre de usuario de la base de datos, vacío por defecto,
--password la contraseña de la base de datos, vacía por defecto,
--database el nombre de la base de datos, public por defecto.

Uso

Integración de escritorio de Claude

Configure el servidor MCP en el archivo de configuración de Claude Desktop:

Sistema operativo Mac

Ubicación: ~/Library/Application Support/Claude/claude_desktop_config.json

Ventanas

Ubicación: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "greptimedb": { "command": "uv", "args": [ "--directory", "/path/to/greptimedb-mcp-server", "run", "-m", "greptimedb_mcp_server.server" ], "env": { "GREPTIMEDB_HOST": "localhost", "GREPTIMEDB_PORT": "4002", "GREPTIMEDB_USER": "root", "GREPTIMEDB_PASSWORD": "", "GREPTIMEDB_DATABASE": "public" } } } }

Licencia

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

Contribuir

Related MCP server: MCP Toolkit

Prerrequisitos

Python con el gestor de paquetes uv
Instalación de GreptimeDB
Dependencias del servidor MCP

Desarrollo

# Clone the repository git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git cd greptimedb-mcp-server # Create virtual environment uv venv source venv/bin/activate # or `venv\Scripts\activate` on Windows # Install development dependencies uv sync # Run tests pytest

Utilice MCP Inspector para depurar:

npx @modelcontextprotocol/inspector uv \ --directory \ /path/to/greptimedb-mcp-server \ run \ -m \ greptimedb_mcp_server.server