servidor greptimedb-mcp

👁 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: SQLite MCP Server

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

Reconocimiento

La implementación de esta biblioteca se inspiró en los siguientes dos repositorios e incorpora su código, por lo que expresamos nuestra gratitud:

• ktanaka101/mcp-server-duckdb

• diseñocomputadora/servidor mysql_mcp

• mikeskarl/plantillas-de-avisos-mcp

¡Gracias!

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_dashboardC
• create_pipelineC
• delete_dashboardC
• delete_pipelineB
• describe_tableA
• dryrun_pipelineA
• execute_sqlA
• execute_tqlC