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 ライセンス のオープンソースソフトウェアです。