mcp-server-openmetadata

基本能力

产品定位

openmetadata-mcp-server 是一个中间件服务，用于桥接 MCP 客户端和 OpenMetadata 的 REST API，提供标准化的元数据管理接口。

核心功能

• 表管理：支持表的创建、更新、删除和查询（通过 ID 或名称）。
• 数据资产查询：支持查询数据库、表、仪表板、管道等数据资产（部分功能未实现）。
• 服务管理：支持数据库服务和仪表板服务的查询（部分功能未实现）。
• 团队和用户管理：支持团队和用户的查询（部分功能未实现）。
• 搜索功能：支持搜索查询、建议和聚合（部分功能未实现）。
• 标签和分类：支持标签的查询（部分功能未实现）。
• 血缘关系：支持获取和更新数据血缘关系（部分功能未实现）。
• 术语表：支持术语表的查询和管理（部分功能未实现）。
• 使用情况：支持查询实体的使用情况（部分功能未实现）。

适用场景

• 元数据管理：在需要统一管理元数据的场景下，通过 MCP 协议标准化访问 OpenMetadata。
• 数据集成：在需要将 OpenMetadata 集成到其他系统或工具中的场景下，提供标准化的接口。
• 开发效率：在开发过程中，通过标准化的接口快速访问和操作元数据。

工具列表

• uvx：用于运行 MCP 服务器的工具。
• uv：另一种运行 MCP 服务器的工具，支持更多配置选项。

常见问题解答

• 认证方式：支持 Token 认证和基本认证两种方式。
• 运行方式：支持通过 uvx 或 uv 工具运行，也可以手动执行 python src/server.py。
• 配置选项：支持通过环境变量或配置文件进行配置。

使用教程

使用依赖

1. 确保已安装 Python 环境。
2. 克隆项目仓库： bash git clone https://github.com/your-repo/mcp-server-openmetadata.git

安装教程

1. 进入项目目录： bash cd mcp-server-openmetadata
2. 安装依赖（如果有 requirements.txt）： bash pip install -r requirements.txt
3. 配置环境变量（选择一种认证方式）：
4. Token 认证： bash export OPENMETADATA_HOST="https://your-openmetadata-host" export OPENMETADATA_JWT_TOKEN="your-jwt-token"
5. 基本认证： bash export OPENMETADATA_HOST="https://your-openmetadata-host" export OPENMETADATA_USERNAME="your-username" export OPENMETADATA_PASSWORD="your-password"

调试方式

1. 运行服务器： bash python src/server.py
2. 可选参数：
3. --port：指定监听端口（默认：8000）。
4. --transport：指定传输类型（stdio/sse，默认：stdio）。
5. 验证服务是否正常运行：
6. 访问 /api/v1/tables 查看表列表。
7. 访问 /api/v1/tables/{id} 查看特定表信息。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。