MCP Server Gravitino

🚀 MCP Server for Apache Gravitino (incubating)

A fast-integrated MCP server - FastMCP that provides MCP API integration for Apache Gravitino (incubating) services.

🚀 Quick Start

This MCP server offers seamless integration with Apache Gravitino (incubating) services, enabling efficient metadata management.

✨ Features

• Integration of MCP API for Apache Gravitino (incubating) services.
• An easy-to-use metadata management interface.
• Support for catalog/schema/table metadata, tags, and user role information.

📦 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 APIs of Gravitino.

Table Tools

• get_list_of_catalogs: Get a list of catalogs and their basic information.
• get_list_of_schemas: Get a list of schemas and their basic information.
• get_list_of_tables: Get a paginated list of tables and their basic information.
• get_table_by_fqn: Get detailed information of 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 tags and their basic information.
• 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 tag.

User Role Tools

• get_list_of_roles: Get a list of roles and their basic information.
• get_list_of_users: Get a list of users and their basic information.
• grant_role_to_user: Grant a role to a user.
• revoke_role_from_user: Revoke a role from a user.

Each tool returns an optimized response containing relevant fields to ensure compatibility with the model's context limits while providing necessary metadata information.

📄 License

This project is open-source software licensed under the Apache License Version 2.0.