MCP OpenMetadata

MCP OpenMetadata

提供 OpenMetadata API 的 MCP 服务——与 OpenMetadata 服务集成的 FastMCP。

功能

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

安装

从 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 提供令牌身份验证和基本身份验证：

令牌身份验证

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

基本身份验证

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

工具列表

mcp-openmetadata 并未提供 OpenMetadata 中所有可用的 API。 可参阅支持的 API，了解可用 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 许可证 授权的开源软件。