hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

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 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
--port el puerto de la base de datos
--user el nombre de usuario de la base de datos
--password la contraseña de la base de datos
--database el nombre de la base de datos

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

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:

¡Gracias!

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Una implementación de servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar de forma segura con GreptimeDB, lo que les permite explorar el esquema de la base de datos, leer datos y ejecutar consultas SQL a través de una interfaz controlada.

Related Resources

Reddit Discussion about this server

GreptimeDB MCP Server