Hologres MCP Server

Connect to a Hologres instance, get table metadata, query and analyze data.

Local serverstdioPython

What is the Hologres MCP server?

Connect to a Hologres instance, get table metadata, query and analyze data. Exposed over MCP by the hologres mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

Hologres MCP Server serves as a universal interface between AI Agents and Hologres databases. It enables seamless communication between AI Agents and Hologres, helping AI Agents retrieve Hologres database metadata and execute SQL operations.

Its toolset

Everything the assistant can do here goes through one of these:

  • execute_hg_select_sql — Execute a SELECT SQL query in Hologres database
  • execute_hg_select_sql_with_serverless — Execute a SELECT SQL query in Hologres database with serverless computing
  • execute_hg_dml_sql — Execute a DML (INSERT, UPDATE, DELETE) SQL query in Hologres database
  • execute_hg_ddl_sql — Execute a DDL (CREATE, ALTER, DROP, COMMENT ON) SQL query in Hologres database
  • gather_hg_table_statistics — Collect table statistics in Hologres database
  • Parameters — schema_name (string), table (string)
  • get_hg_query_plan — Get query plan in Hologres database
  • get_hg_execution_plan — Get execution plan in Hologres database
  • call_hg_procedure — Invoke a procedure in Hologres database
  • create_hg_maxcompute_foreign_table — Create MaxCompute foreign tables in Hologres database
  • list_hg_schemas — Lists all schemas in the current Hologres database, excluding system schemas
  • list_hg_tables_in_a_schema — Lists all tables in a specific schema, including their types (table, view, external table, partitioned table)

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at mode on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration

You will need 5 environment variables: HOLOGRES_HOST, HOLOGRES_PORT, HOLOGRES_USER, HOLOGRES_PASSWORD, HOLOGRES_DATABASE. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

When to reach for it

Among the database access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Hologres's toolset — execute_hg_select_sql, execute_hg_select_sql_with_serverless, execute_hg_dml_sql and 11 more — is a fair guide to whether it matches your workflow.

This entry was verified against Hologres's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Hologres.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the hologres mcp server does with a few real requests.

Available tools

ToolWhat it does
execute_hg_select_sqlExecute a SELECT SQL query in Hologres database
execute_hg_select_sql_with_serverlessExecute a SELECT SQL query in Hologres database with serverless computing
execute_hg_dml_sqlExecute a DML (INSERT, UPDATE, DELETE) SQL query in Hologres database
execute_hg_ddl_sqlExecute a DDL (CREATE, ALTER, DROP, COMMENT ON) SQL query in Hologres database
gather_hg_table_statisticsCollect table statistics in Hologres database
Parametersschema_name (string), table (string)
get_hg_query_planGet query plan in Hologres database
get_hg_execution_planGet execution plan in Hologres database
call_hg_procedureInvoke a procedure in Hologres database
create_hg_maxcompute_foreign_tableCreate MaxCompute foreign tables in Hologres database.
list_hg_schemasLists all schemas in the current Hologres database, excluding system schemas.
list_hg_tables_in_a_schemaLists all tables in a specific schema, including their types (table, view, external table, partitioned table).
show_hg_table_ddlShow the DDL script of a table, view, or external table in the Hologres database.
query_and_plotly_chartExecute a SELECT SQL query and generate a chart (bar, line, scatter, pie, histogram, area). Returns query results and a base64-encoded PNG image.

How to install the Hologres MCP server

Use uvx mode

```json
{
    "mcpServers": {
        "hologres-mcp-server": {
            "command": "uvx",
            "args": [
                "hologres-mcp-server"
            ],
            "env": {
                "HOLOGRES_HOST": "host",
                "HOLOGRES_PORT": "port",
                "HOLOGRES_USER": "access_id",
                "HOLOGRES_PASSWORD": "access_key",
                "HOLOGRES_DATABASE": "database"
            }
        }
    }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
HOLOGRES_HOSTEndpoint or connection string the server talks to.Optional
HOLOGRES_PORTConfiguration value read at startup.Optional
HOLOGRES_USERConfiguration value read at startup.Optional
HOLOGRES_PASSWORDConfiguration value read at startup.Optional
HOLOGRES_DATABASEConfiguration value read at startup.Optional

Example prompts to try

  • Use Hologres to execute hg select sql.
  • Use Hologres to execute hg select sql with serverless.
  • Use Hologres to execute hg dml sql.

Frequently asked questions

It connects Hologres to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (execute_hg_select_sql, execute_hg_select_sql_with_serverless, execute_hg_dml_sql, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Hologres directly.