MCP Gravitino

🚀 Apache Gravitino (Incubating) MCP Server


This project offers a quick integration of FastMCP, providing the integration of MCP API for Apache Gravitino (Incubating) services.

✨ Features

• Integrate FastMCP with Gravitino API.
• An easy - to - use metadata management interface.
• Support metadata, tags, and user role information for catalogs/schemas/tables.

📦 Installation

Install from the configuration file

{
    "mcpServers": {
        "Gravitino": {
            "command": "uv",
            "args": [
              "--directory",
              "/Users/user/workspace/mcp-server-gravitino",
                "run",
                "--with",
                "fastmcp",
                "--with",
                "httpx",
                "--with",
                "mcp-server-gravitino",
                "python",
                "-m",
                "mcp_server_gravitino.server"
            ],
            "env": {
                "GRAVITINO_URI": "http://localhost:8090",
                "GRAVITINO_USER_NAME": "admin",
                "GRAVITINO_PASSWORD": "admin",
                "GRAVITINO_METALAKE": "metalake_demo"
            }
        }
    }
}

📚 Documentation

Environment Variables

Authorization

mcp-server-gravitino provides token authentication and basic authentication:

Token Authentication

GRAVITINO_URI=http://localhost:8090
GRAVITINO_JWT_TOKEN=<YOUR GRAVITINO JWT TOKEN>

Basic Authentication

GRAVITINO_URI=http://localhost:8090
GRAVITINO_USERNAME=<YOUR GRAVITINO USERNAME>
GRAVITINO_PASSWORD=<YOUR GRAVITINO PASSWORD>

Tool List

mcp-server-gravitino does not provide all the APIs of Gravitino.

Table Tools

• get_list_of_catalogs: Get a list of basic information about catalogs.
• get_list_of_schemas: Get a list of basic information about schemas.
• get_list_of_tables: Get a paginated list of tables and their basic information.
• get_table_by_fqn: Get detailed information about a table by its fully qualified name.
• get_table_columns_by_fqn: Get column information of a table by its fully qualified name.

Tag Tools

• get_list_of_tags: Get a list of basic information about tags.
• associate_tag_to_table: Associate a tag with a table.
• associate_tag_to_column: Associate a tag with a column.
• list_objects_by_tag: Get a list of objects associated with a specific tag.

User Role Tools

• get_list_of_roles: Get a list of basic information about roles.
• get_list_of_users: Get a list of users.