greptimedb-mcp-server

A Model Context Protocol (MCP) server implementation for GreptimeDB

Catalog onlyCatalog onlySTDIO

Overview

The greptimedb-mcp-server is a Model Context Protocol (MCP) server implementation for GreptimeDB, designed to provide AI assistants with a secure and structured way to explore and analyze databases.

To use the greptimedb-mcp-server, install it via pip and configure the necessary environment variables or command-line arguments to connect to your GreptimeDB instance. Then, integrate it with Claude Desktop for seamless operation.

Secure access to database tables and data. - Ability to execute SQL queries through a controlled interface. - Integration with AI assistants for enhanced database interaction.

Enabling AI assistants to perform data analysis on GreptimeDB.
Allowing users to list and query database tables securely.
Facilitating structured database access for various applications.

Add to your AI client

Use these steps to connect greptimedb-mcp-server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "greptimedb-mcp-server-greptimeteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "greptimedb-mcp-server-greptimeteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "greptimedb-mcp-server-greptimeteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "greptimedb-mcp-server-greptimeteam": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "greptimedb-mcp-server-greptimeteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "greptimedb-mcp-server-greptimeteam": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-greptimedb-mcp-server-greptimeteam"
      ]
    }
  }
}

FAQ

What is the installation process?

You can install it using `pip install greptimedb-mcp-server`.

How do I configure the server?

Set the required environment variables or use command-line arguments to specify database connection details.

Is there a license for this project?

Yes, it is licensed under the MIT License.

Developer tools