🚀 Apache Gravitino（孵化中）的 MCP 服务器

本项目为 Apache Gravitino（孵化中）服务提供 MCP API 的整合，实现了 FastMCP 的快速集成，助力用户更高效地管理元数据。

🚀 快速开始

本项目为 Apache Gravitino（孵化中）服务提供 MCP API 的整合——FastMCP 的快速集成，让你能轻松开展元数据管理工作。

✨ 主要特性

• 集成 FastMCP 与 Gravitino API，实现高效的 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：获取用户的