datastrato/mcp-server-gravitino

MCP server providing Gravitino APIs - A FastMCP integration for Apache Gravitino services.
Features
* 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
Installation
This project uses uv as the dependency and virtual environment management tool. Please ensure uv is installed on your system.
1. Clone the repository:
2. Navigate into the project directory:
3. Create a virtual environment:
4. Activate the virtual environment:
5. Install dependencies:
Configuration
Common Configuration
Regardless of the Authorization, the following environment variables need to be set:
* GRAVITINO_URI: The base URL of your Gravitino server.
* GRAVITINO_METALAKE: The name of the metakube to use.
Authorization
mcp-server-gravitino supports both token-based and basic authentication methods. These mechanisms allow secure access to MCP tools and prompts and are suitable for integration with external systems.
Token Authentication
Set the following environment variables:
GRAVITINO_JWT_TOKEN: The JWT token for authentication.
Basic Authentication
Alternatively, you can use basic authentication:
* GRAVITINO_USERNAME: The username for Gravitino authentication.
* GRAVITINO_PASSWORD: The corresponding password.
Tool Activation
Tool activation is currently based on method names (e.g., get_list_of_table). You can specify which tools to activate by setting the optional environment variable GRAVITINO_ACTIVE_TOOLS. The default value is *, which activates all tools. If just want to activate get_list_of_roles tool, you can set the environment variable as follows:
Usage
To launch the Gravitino MCP Server, run the following command:
The meaning of each argument is as follows:
| Argument | Description |
| --------------------------------------- | ----------------------------------------------------------------------- |
| uv | Launches the UV CLI tool |
| --directory /path/to/mcp-gravitino | Specifies the working project directory with pyproject.toml |
| run | Indicates that a command will be executed in the managed environment |
| --with fastmcp | Adds fastmcp to the runtime environment without altering project deps |
| --with httpx | Adds httpx dependency for async HTTP functionality |
| --with mcp-server-gravitino | Adds the local module as a runtime dependency |
| python -m mcp_server_gravitino.server | Starts the MCP server using the package's entry module |
Goose Client Example
Example configuration to run the server using Goose:
Tool List
mcp-server-gravitino does not expose all Gravitino APIs, but provides a selected set of optimized tools:
Table Tools
* get_list_of_catalogs: Retrieve a list of catalogs