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 授权。