MCP OpenMetadata

MCP 服务器，提供 OpenMetadata API - 用于 OpenMetadata 服务的 FastMCP 集成。

特性

• OpenMetadata API 与 FastMCP 集成
• 易于使用的元数据管理界面
• 支持表元数据、示例数据和所有权信息

安装

从 PyPi (Cursor) 安装

使用 (uv) 安装到 Cursor：

uv pip install mcp-openmetadata

uv run python -m mcp-openmetadata.hosts.cursor \
  -e OPENMETADATA_URI=<YOUR OPENMETADATA URI> \
  -e OPENMETADATA_JWT_TOKEN=<YOUR OPENMETADATA JWT TOKEN>

使用 (pip) 安装到 Cursor：

pip install mcp-openmetadata

python -m mcp-openmetadata.hosts.cursor \
  -e OPENMETADATA_URI=<YOUR OPENMETADATA URI> \
  -e OPENMETADATA_JWT_TOKEN=<YOUR OPENMETADATA JWT TOKEN>

从配置安装

{
    "mcpServers": {
        "OpenMetadata": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "fastmcp",
                "--with",
                "httpx",
                "--with",
                "mcp-openmetadata",
                "python",
                "-m",
                "mcp_openmetadata.server"
            ],
            "env": {
                "OPENMETADATA_URI": "http://localhost:8585",
                "OPENMETADATA_JWT_TOKEN": "awesome_jwt_token"
            }
        }
    }
}

环境变量

授权

mcp-openmetadata 提供 Token 认证和 Basic 认证：

Token 认证

OPENMETADATA_URI=http://localhost:8585
OPENMETADATA_JWT_TOKEN=<YOUR OPENMETADATA JWT TOKEN>

Basic 认证

OPENMETADATA_URI=http://localhost:8585
OPENMETADATA_USERNAME=<YOUR OPENMETADATA USERNAME>
OPENMETADATA_PASSWORD=<YOUR OPENMETADATA PASSWORD>

工具列表

mcp-openmetadata 不提供 OpenMetadata 中所有可用的 API。 请参考 Supported APIs 获取可用 API 列表。

由于直接使用原始 API 包含太多不必要的数据，难以适应模型上下文，因此我们正在努力返回经过一定整理的结果。

搜索工具

• search_entities_with_query: 使用查询文本搜索实体。支持分页和排序。适用于：
  • 列出所有表/主题 (q=*)
  • 按字段名称搜索 (例如，q=columnNames:address)
  • 按标签搜索 (例如，q=tags.tagFQN:user.email)
  • 带有 AND/OR 运算符的复杂查询
  • 按服务类型、约束、所有者等进行过滤

表工具

• get_list_of_tables: 获取包含基本信息的表的分页列表
• get_table_by_fqn: 通过完全限定名称获取详细的表信息
• get_table_columns_by_fqn: 通过完全限定名称获取表列信息
• get_table_owners_by_fqn: 通过完全限定名称获取表所有权信息
• get_sample_data: 从指定的表中获取示例数据

每个工具都返回优化的响应，其中包含相关字段，以确保与模型上下文限制的兼容性，同时提供必要的元数据信息。

许可证

本项目是开源软件，采用 MIT 许可证。