MCP Server Gravitino

🚀 用於 Apache Gravitino(incubating) 的 MCP 服務器

本項目為 Apache Gravitino(incubating) 服務提供 MCP API 集成的 MCP 服務器 - FastMCP 的快速集成方案。藉助該服務器，能輕鬆實現對元數據的管理，提升數據處理效率。

✨ 主要特性

• MCP API 集成：實現 Apache Gravitino(incubating) 服務的 MCP API 集成。
• 簡易元數據管理：提供簡單易用的元數據管理接口。
• 多類型元數據支持：支持目錄/模式/表元數據、標籤和用戶角色信息。

📦 安裝指南

從配置文件中安裝

可通過以下配置文件進行安裝：

{
    "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"
            }
        }
    }
}

📚 詳細文檔

環境變量

授權

mcp-server-gravitino 提供令牌認證和基本認證兩種方式：

令牌認證

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

基本認證

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

工具列表

mcp-server-gravitino 並不提供 Gravitino 所有的 API，以下是可用的工具介紹：

表工具

• get_list_of_catalogs：獲取目錄的列表及其基本信息。
• get_list_of_schemas：獲取模式的列表及其基本信息。
• get_list_of_tables：獲取表的分頁列表及其基本信息。
• get_table_by_fqn：通過完全限定名稱獲取表的詳細信息。
• get_table_columns_by_fqn：通過完全限定名稱獲取表的列信息。

標籤工具

• get_list_of_tags：獲取標籤的列表及其基本信息。
• associate_tag_to_table：將標籤關聯到表。
• associate_tag_to_column：將標籤關聯到列。
• list_objects_by_tag：獲取與標籤相關聯的對象列表。

用戶角色工具

• get_list_of_roles：獲取角色的列表及其基本信息。
• get_list_of_users：獲取用戶的列表及其基本信息。
• grant_role_to_user：授予用戶角色。
• revoke_role_from_user：撤銷用戶的角色。

每個工具都返回經過優化的響應，包含相關字段以確保與模型上下文限制兼容，同時提供必要的元數據信息。

📄 許可證

此項目是開源軟件，採用 Apache License Version 2.0 授權。