GreptimeDB MCP

Install from the author’s instructions

Before connecting

• Install the published greptimedb-mcp-server package and make its executable available to your MCP client.
• Provide a running GreptimeDB instance; the example targets localhost and the public database.

# Install
pip install greptimedb-mcp-server

# Run (connects to localhost:4002 by default)
greptimedb-mcp-server --host localhost --database public

Sources: Author README · Checked 2026-10-14.

{
  "mcpServers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": [
        "--host",
        "localhost",
        "--database",
        "public"
      ]
    }
  }
}

Sources: Author README · Checked 2026-10-14.

The author’s example uses the local defaults. Configure credentials for your own deployment. Write operations require explicit enablement; use a database account with appropriate read permissions.

Sources: Author README · Checked 2026-10-14.

Tools and capabilities

Sources: Author README · Checked 2026-10-14.

Workflow examples

Suggested prompts for your own client. These are examples, not recorded tool executions.

Describe the schema and recent samples for my GreptimeDB metrics table, then suggest a time-window aggregation.

Use a bounded TQL range query to compare a metric across two time windows I specify, and explain missing samples.

Sources and verification

Author README, linked first-party setup instructions and public repository metadata reviewed on 2026-10-14. No third-party package was installed, no MCP server was executed, and no hosted service was connected.

Recent activity refers to the repository push timestamp. It does not establish the product’s original release date. Stars are a dated snapshot of the entire repository.

1. GitHub repository metadataVerified 2026-10-14
2. Author READMEVerified 2026-10-14

Related guides

Browse every new addition → · Full directory →