Gravitino MCP Server

MCP server providing Gravitino APIs - A FastMCP integration for Apache Gravitino services.

Local serverstdioPython

What is the Gravitino MCP server?

MCP server providing Gravitino APIs - A FastMCP integration for Apache Gravitino services. The gravitino mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

  • Seamless integration with FastMCP for Gravitino APIs
  • Simplified interface for metadata interaction
  • Supports metadata operations for catalogs, schemas, tables, models, users, tags, and user-role management

Its toolset

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

  • get_list_of_catalogs — Retrieve a list of catalogs
  • get_list_of_schemas — Retrieve a list of schemas
  • get_list_of_tables — Retrieve a paginated list of tables
  • get_table_by_fqn — Fetch detailed information for a specific table
  • get_table_columns_by_fqn — Retrieve column information for a table
  • get_list_of_tags — Retrieve all tags
  • associate_tag_to_entity — Attach a tag to a table or column
  • list_objects_by_tag — List objects associated with a specific tag
  • get_list_of_roles — Retrieve all roles
  • get_list_of_users — Retrieve all users
  • grant_role_to_user — Assign a role to a user
  • revoke_role_from_user — Revoke a user's role

Configuration

You will need 6 environment variables: GRAVITINO_URI, GRAVITINO_USERNAME, GRAVITINO_PASSWORD, GRAVITINO_METALAKE, GRAVITINO_JWT_TOKEN, YOUR_GRAVITINO_JWT_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

When to reach for it

Among the developer tooling 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. Gravitino's toolset — get_list_of_catalogs, get_list_of_schemas, get_list_of_tables and 11 more — is a fair guide to whether it matches your workflow. It is maintained by datastrato; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Gravitino'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 Gravitino.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the gravitino mcp server does with a few real requests.

Available tools

ToolWhat it does
get_list_of_catalogsRetrieve a list of catalogs
get_list_of_schemasRetrieve a list of schemas
get_list_of_tablesRetrieve a paginated list of tables
get_table_by_fqnFetch detailed information for a specific table
get_table_columns_by_fqnRetrieve column information for a table
get_list_of_tagsRetrieve all tags
associate_tag_to_entityAttach a tag to a table or column
list_objects_by_tagList objects associated with a specific tag
get_list_of_rolesRetrieve all roles
get_list_of_usersRetrieve all users
grant_role_to_userAssign a role to a user
revoke_role_from_userRevoke a user's role
get_list_of_modelsRetrieve a list of models
get_list_of_model_versions_by_fqnGet versions of a model by fully qualified name

Configuration

VariableDescriptionRequired
GRAVITINO_URIConfiguration value read at startup.Optional
GRAVITINO_USERNAMEConfiguration value read at startup.Optional
GRAVITINO_PASSWORDConfiguration value read at startup.Optional
GRAVITINO_METALAKEConfiguration value read at startup.Optional
GRAVITINO_JWT_TOKENCredential the server authenticates with.Yes
YOUR_GRAVITINO_JWT_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Gravitino to get list of catalogs.
  • Use Gravitino to get list of schemas.
  • Use Gravitino to get list of tables.

Frequently asked questions

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