mcp-server-openmetadata

一个用于 OpenMetadata 的模型上下文协议 (MCP) 服务器实现，能够与 MCP 客户端无缝集成。该项目提供了一种通过模型上下文协议与 OpenMetadata 交互的标准化方式。

<a href="https://glama.ai/mcp/servers/lvgl5cmxa6"> <img width="380" height="200" src="https://glama.ai/mcp/servers/lvgl5cmxa6/badge" alt="Server for OpenMetadata MCP server" /> </a>

关于

该项目实现了一个 模型上下文协议 服务器，它封装了 OpenMetadata 的 REST API，允许 MCP 客户端以标准化方式与 OpenMetadata 交互。

功能实现状态

功能	API 路径	状态
数据资产
列出数据库	/api/v1/databases	❌
获取数据库	/api/v1/databases/{id}	❌
通过名称获取数据库	/api/v1/databases/name/{fqn}	❌
导出数据库	/api/v1/databases/name/{name}/export	❌
导入数据库	/api/v1/databases/name/{name}/import	❌
列出表	/api/v1/tables	✅
获取表	/api/v1/tables/{id}	✅
通过名称获取表	/api/v1/tables/name/{fqn}	✅
创建表	/api/v1/tables	✅
更新表	/api/v1/tables/{id}	✅
删除表	/api/v1/tables/{id}	✅
导出表	/api/v1/tables/name/{name}/export	❌
导入表	/api/v1/tables/name/{name}/import	❌
列出指标	/api/v1/metrics	❌
获取指标	/api/v1/metrics/{id}	❌
列出仪表板	/api/v1/dashboards	❌
获取仪表板	/api/v1/dashboards/{id}	❌
通过名称获取仪表板	/api/v1/dashboards/name/{fqn}	❌
列出报告	/api/v1/reports	❌
获取报告	/api/v1/reports/{id}	❌
列出管道	/api/v1/pipelines	❌
获取管道	/api/v1/pipelines/{id}	❌
通过名称获取管道	/api/v1/pipelines/name/{fqn}	❌
列出主题	/api/v1/topics	❌
获取主题	/api/v1/topics/{id}	❌
服务
列出数据库服务	/api/v1/services/databaseServices	❌
获取数据库服务	/api/v1/services/databaseServices/{id}	❌
通过名称获取数据库服务	/api/v1/services/databaseServices/name/{fqn}	❌
导出数据库服务	/api/v1/services/databaseServices/name/{name}/export	❌
导入数据库服务	/api/v1/services/databaseServices/name/{name}/import	❌
列出仪表板服务	/api/v1/services/dashboardServices	❌
获取仪表板服务	/api/v1/services/dashboardServices/{id}	❌
通过名称获取仪表板服务	/api/v1/services/dashboardServices/name/{fqn}	❌
团队 & 用户
列出团队	/api/v1/teams	❌
获取团队	/api/v1/teams/{id}	❌
通过名称获取团队	/api/v1/teams/name/{fqn}	❌
导出团队	/api/v1/teams/name/{name}/export	❌
导入团队	/api/v1/teams/name/{name}/import	❌
列出用户	/api/v1/users	❌
获取用户	/api/v1/users/{id}	❌
通过名称获取用户	/api/v1/users/name/{name}	❌
用户登录	/api/v1/users/login	❌
用户登出	/api/v1/users/logout	❌
用户注册	/api/v1/users/signup	❌
更改密码	/api/v1/users/changePassword	❌
搜索
搜索查询	/api/v1/search/query	❌
搜索建议	/api/v1/search/suggest	❌
搜索聚合	/api/v1/search/aggregate	❌
字段查询	/api/v1/search/fieldQuery	❌
获取文档	/api/v1/search/get/{index}/doc/{id}	❌
标签 & 分类
列出标签	/api/v1/tags	❌
获取标签	/api/v1/tags/{id}	❌
通过名称获取标签	/api/v1/tags/name/{fqn}	❌
血缘
获取血缘	/api/v1/lineage/getLineage	❌
导出血缘	/api/v1/lineage/export	❌
通过名称获取实体血缘	/api/v1/lineage/{entity}/name/{fqn}	❌
通过 ID 获取实体血缘	/api/v1/lineage/{entity}/{id}	❌
获取血缘边	/api/v1/lineage/getLineageEdge/{fromId}/{toId}	❌
添加/更新血缘	/api/v1/lineage	❌
通过 FQN 添加/更新血缘	/api/v1/lineage/{fromEntity}/name/{fromFQN}/{toEntity}/name/{toFQN}	❌
通过 ID 添加/更新血缘	/api/v1/lineage/{fromEntity}/{fromId}/{toEntity}/{toId}	❌
词汇表
列出词汇表	/api/v1/glossaries	❌
获取词汇表	/api/v1/glossaries/{id}	❌
通过名称获取词汇表	/api/v1/glossaries/name/{fqn}	❌
导出词汇表	/api/v1/glossaries/name/{name}/export	❌
导入词汇表	/api/v1/glossaries/name/{name}/import	❌
列出词汇表术语	/api/v1/glossaryTerms	❌
获取词汇表术语	/api/v1/glossaryTerms/{id}	❌
通过名称获取词汇表术语	/api/v1/glossaryTerms/name/{fqn}	❌
将资产添加到术语	/api/v1/glossaryTerms/{id}/assets/add	❌
从术语中删除资产	/api/v1/glossaryTerms/{id}/assets/remove	❌
验证术语标签	/api/v1/glossaryTerms/{id}/tags/validate	❌
使用情况
通过名称获取实体使用情况	/api/v1/usage/{entity}/name/{fqn}	❌
通过 ID 获取实体使用情况	/api/v1/usage/{entity}/{id}	❌

设置

环境变量

设置以下身份验证方法之一：

令牌身份验证（推荐）

OPENMETADATA_HOST=<你的-openmetadata-主机>
OPENMETADATA_JWT_TOKEN=<你的-jwt-令牌>

基本身份验证

OPENMETADATA_HOST=<你的-openmetadata-主机>
OPENMETADATA_USERNAME=<你的-用户名>
OPENMETADATA_PASSWORD=<你的-密码>

与 Claude Desktop 一起使用

使用以下身份验证方法之一添加到您的 claude_desktop_config.json：

令牌身份验证（推荐）

{
  "mcpServers": {
    "mcp-server-openmetadata": {
      "command": "uvx",
      "args": ["mcp-server-openmetadata"],
      "env": {
        "OPENMETADATA_HOST": "https://你的-openmetadata-主机",
        "OPENMETADATA_JWT_TOKEN": "你的-jwt-令牌"
      }
    }
  }
}

基本身份验证

{
  "mcpServers": {
    "mcp-server-openmetadata": {
      "command": "uvx",
      "args": ["mcp-server-openmetadata"],
      "env": {
        "OPENMETADATA_HOST": "https://你的-openmetadata-主机",
        "OPENMETADATA_USERNAME": "你的-用户名",
        "OPENMETADATA_PASSWORD": "你的-密码"
      }
    }
  }
}

使用 uv 的替代配置：

令牌身份验证（推荐）

{
  "mcpServers": {
    "mcp-server-openmetadata": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-openmetadata",
        "run",
        "mcp-server-openmetadata"
      ],
      "env": {
        "OPENMETADATA_HOST": "https://你的-openmetadata-主机",
        "OPENMETADATA_JWT_TOKEN": "你的-jwt-令牌"
      }
    }
  }
}

基本身份验证

{
  "mcpServers": {
    "mcp-server-openmetadata": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-openmetadata",
        "run",
        "mcp-server-openmetadata"
      ],
      "env": {
        "OPENMETADATA_HOST": "https://你的-openmetadata-主机",
        "OPENMETADATA_USERNAME": "你的-用户名",
        "OPENMETADATA_PASSWORD": "你的-密码"
      }
    }
  }
}

将 /path/to/mcp-server-openmetadata 替换为您克隆存储库的实际路径。

手动执行

您也可以手动运行服务器：

python src/server.py

选项：

• --port: SSE 监听端口（默认：8000）
• --transport: 传输类型（stdio/sse，默认：stdio）

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证