MCP server for Apache Gravitino(incubating)

What is MCP server for Apache Gravitino(incubating)?

It is an MCP server that provides a FastMCP integration for Apache Gravitino services, offering a simplified interface for metadata interaction. It supports metadata operations for catalogs, schemas, tables, models, users, tags, and user-role management. It is intended for users who want to interact with Gravitino metadata through an MCP-compatible client.

How to use MCP server for Apache Gravitino(incubating)?

Install dependencies with uv, set environment variables for the Gravitino server URI and metalake, optionally configure authentication (JWT token or basic auth), and optionally activate specific tools via GRAVITINO_ACTIVE_TOOLS. Then run the server using the provided uv command, which includes fastmcp and httpx dependencies. An example configuration for the Goose client is provided in the README.

Key features of MCP server for Apache Gravitino(incubating)

• Seamless integration with FastMCP for Gravitino APIs
• Simplified interface for metadata interaction
• Supports catalogs, schemas, tables, models, users, tags, and user-role management
• Token-based and basic authentication methods
• Tool activation via method names
• Designed to stay within LLM token limits

Use cases of MCP server for Apache Gravitino(incubating)

• Retrieve metadata about catalogs, schemas, and tables from Gravitino
• Manage tags and associate them with tables or columns
• Manage users and roles, including granting and revoking roles
• List and fetch details of models and model versions

FAQ from MCP server for Apache Gravitino(incubating)

What authentication methods are supported?

The server supports both token-based authentication (using a JWT token) and basic authentication (username/password). Set the corresponding environment variables (GRAVITINO_JWT_TOKEN or GRAVITINO_USERNAME/GRAVITINO_PASSWORD).

How do I activate only specific tools?

Set the optional environment variable GRAVITINO_ACTIVE_TOOLS to a comma-separated list of method names (e.g., get_list_of_roles). The default value * activates all tools.

What are the system requirements?

Python 3.10 or later, the uv tool for dependency management, and the fastmcp and httpx packages. The server connects to a running Apache Gravitino instance.

Is there an example configuration for the Goose client?

Yes, the README includes a JSON snippet showing how to configure the client using uv and environment variables for a Gravitino server running at http://localhost:8090.

What operations does the tool list cover?

The server provides tools for tables (list catalogs, schemas, tables, get table details/columns), tags (list, associate, list objects), user roles (list roles/users, grant/revoke), and models (list models, get model versions). It does not expose all Gravitino APIs.