MCP Openmetadata

🚀 MCP オープンメタデータ

MCP サーバーは、OpenMetadata サービス用に OpenMetadata API - 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 はトークン認証と基本認証を提供します:

トークン認証

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=label:*)
  • 条件でフィルタリングする (例: q=state:"running" または q=!state:"stopped")
  • 特定のタイプのすべてのエンティティを検索する (例: q=:///。詳細な例は OpenMetadata ドキュメントを参照)

テーブルメタデータツール

• get_table：データベースとテーブル名に基づいてテーブルの詳細情報を取得します。
• get_columns：指定されたテーブルのすべての列情報を取得します。

サポートされている API

現在、mcp-openmetadata は以下の OpenMetadata API のみをサポートしています:

1. エンティティ検索 (search_entities_with_query)
2. テーブルメタデータ (get_table, get_columns)

他の機能が必要な場合は、OpenMetadata ドキュメント を参照するか、プロジェクトのメンテナに連絡してください。

💻 使用例

トークン認証を使用してインストールして実行

pip install mcp-openmetadata
python -m mcp_openmetadata.hosts.cursor \
  --bind 0.0.0.0:12345 \
  --name openMetadata \
  --set mcp.openMetadata.authProvider.jwt.token=your_jwt_token \
  --set mcp.openMetadata.authProvider.type=jwt

基本認証を使用してインストールして実行

pip install mcp-openmetadata
python -m mcp_openmetadata.hosts.cursor \
  --bind 0.0.0.0:12345 \
  --name openMetadata \
  --set mcp.openMetadata.authProvider.basic.username=your_username \
  --set mcp.openMetadata.authProvider.type=basic \
  --set mcp.openMetadata.authProvider.basic.password=your_password

テーブルメタデータをクエリする例

別のターミナルで:

curl -X POST "http://localhost:12345/v1/table" \
     -H "Content-Type: application/json" \
     -d '{"name": {"database": "my-database", "table": "my-table"}}'

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。