servidor greptimedb-mcp

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!