tableau-graphql-mcp

tableau-graphql-mcp

Tableau Metadata API を通じて、あらゆる MCP クライアントから Tableau のリネージに関する質問をできます。

tableau-graphql-mcp は、Tableau サイトの Metadata API を MCP ツールのセットに変換します。これにより、AI アシスタント（Claude、Cursor、Cline など）が自然な言葉でリネージに関する質問に回答できます。

• 「列 SALES を削除すると、どのワークブックに影響しますか？」
• 「Sales Overview ワークブックはどのテーブルに依存していますか？」
• 「Profit を参照する計算フィールドはどれで、どのダッシュボードにありますか？」
• 「DIM_CUSTOMER テーブルを変更する前に、誰に通知すべきですか？」

厳選された7つのツールが含まれています。汎用 GraphQL パススルー、リアルタイムのスキーマイントロスペクション、正確なクエリテンプレートを収録した組み込みライブラリ、堅牢な where_used リゾルバー、複数段階の impact_analysis、部分文字列によるコンテンツ検索、接続プローブです。これらを組み合わせることで、固定された質問メニューに限らず、モデルがあらゆるリネージに関する質問に回答できます。

他との違い

• どんな質問にも、的確に回答します。 graphql_query は読み取り専用の任意の GraphQL クエリを実行します。introspect_schema と組み込みのチートシート、28 件の実例により、モデルは正しいクエリを作成できます。
• 正確な影響分析（多段階）。 impact_analysis は依存関係の全経路をたどります（計算フィールドを基にした計算フィールドをさらに基にした列も含まれます）。直接参照だけでなく、影響範囲全体と重複を除いた通知すべき所有者を返します。
• どこでも動作します。 Tableau Server と Cloud の両方に対応します。REST API のバージョンと GraphQL エンドポイント（/api/metadata/graphql、利用できない場合は /relationship-service-war/graphql）は自動検出されます。
• Catalog がなくても、堅牢なリネージを提供します。 where_used はコアリネージ（referencedByFields -> sheets -> workbook）を使ってワークブックを特定するため、Data Management アドオンの downstreamWorkbooks が空でも動作します。
• 結果が黙って切り詰められることはありません。 クエリがノード数の上限に達すると、graphql_query は partial_results を示します。また、search_content は scanned／total で網羅状況を報告するため、切り詰められた回答を完全な結果と誤認することはありません。
• 小さく、安全です。 読み取り専用、stdio のみ（受信用ポートなし）、シークレットは環境変数からのみ取得し、MCP SDK 以外の依存関係はありません（HTTP 通信には標準ライブラリの urllib を使用します）。

クイックスタート

uv（curl -LsSf https://astral.sh/uv/install.sh | sh）と Tableau の個人用アクセストークンが必要です。

Claude Code の場合、1 行で設定できます：

claude mcp add tableau-graphql \
  -e TABLEAU_SERVER=https://10ax.online.tableau.com \
  -e TABLEAU_SITE_CONTENT_URL=YourSite \
  -e TABLEAU_PAT_NAME=my-token \
  -e TABLEAU_PAT_SECRET=the-full-secret \
  -- uvx tableau-graphql-mcp

これで完了です。uvx が PyPI からパッケージを取得し、分離された環境で実行します。クローンやインストールは不要です（git も必要ありません）。その後、Claude にリネージについて質問してください。

設定

設定はすべて環境変数を通じて行います（クライアントの env ブロックに設定し、コマンドラインには設定しないでください）。

¹ PAT（TABLEAU_PAT_NAME と TABLEAU_PAT_SECRET）または高度な設定の TABLEAU_AUTH_TOKEN／TABLEAU_COOKIE のいずれかを指定してください。

{
  "mcpServers": {
    "tableau-graphql": {
      "command": "uvx",
      "args": ["tableau-graphql-mcp"],
      "env": {
        "TABLEAU_SERVER": "https://10ax.online.tableau.com",
        "TABLEAU_SITE_CONTENT_URL": "YourSite",
        "TABLEAU_PAT_NAME": "my-token",
        "TABLEAU_PAT_SECRET": "the-full-secret"
      }
    }
  }
}

ツール

すべてのツールは読み取り専用です。Metadata API には変更操作がありません。

プロンプトの例

接続したら、次のように試してみてください。

• 「server_info を使って、何に接続しているか確認してください。」
• 「名前に『revenue』が含まれるものを検索してください。」
• 「SALES、PROFIT、DISCOUNT の列を使っているワークブックはどれですか？　所有者ごとにまとめてください。」
• 「『Sales Overview』ワークブックのフィールドとソース列の対応表を表示してください。」
• 「そのワークブックにある計算フィールドを、数式とともにすべて一覧表示してください。」
• 「Analytics プロジェクトのワークブックにデータを提供している公開済みデータソースはどれですか？　また、未認定のものはどれですか？」
• 「『Profit Ratio』フィールドに対して impact_analysis を実行してください。依存するシート、ダッシュボード、ワークブックをすべて挙げ、通知すべき所有者も示してください。」
• 「DIM_CUSTOMER テーブルを削除した場合の影響範囲はどれくらいですか？　ワークブック、シート、通知すべき所有者を挙げてください。」

アーキテクチャ

サーバーはクライアントとは stdio で、Tableau とは HTTPS で MCP 通信を行います。お使いの PAT でサインインして X-Tableau-Auth トークンを取得し（有効期限切れ時は自動更新）、REST API のバージョンと GraphQL エンドポイントを自動検出してから、クエリを Metadata API に転送します。データは保存されず、すべての回答はその時点の情報です。

セキュリティ

• 読み取り専用を徹底。 GraphQL クエリのみを使用し、書き込みやシェル操作はありません。graphql_query は mutation／subscription 操作を拒否し、Metadata API もいずれにせよクエリ専用です。
• 読み取り専用を明示。 すべてのツールに MCP の readOnlyHint アノテーションが付いているため、クライアントはコードを読まずに確認できます。
• ローカルかつ stdio 専用。 外部から接続できるネットワークポートは開きません。
• シークレットは環境変数からのみ取得。 ツールの引数として渡されず、ログにも記録されず、出力にも返されません。
• 認証情報の送信先は Tableau ホストのみ。 HTTPS が必須で、証明書を検証し、リダイレクトは拒否します。
• 最小権限。 PAT は Tableau の権限を引き継ぎ、API が返すのは閲覧可能なコンテンツのみです。
• 検証可能なリリース。 GitHub の各リリースには Sigstore 署名と CycloneDX SBOM が付属し、PyPI へのアップロードには Trusted Publishing を使用します。
• 本番環境ではバージョンを固定してください：uvx tableau-graphql-mcp==0.2.0。

脅威モデル、データの取り扱い、脆弱性の開示ポリシー、リリースの検証方法については、SECURITY.md を参照してください。

トラブルシューティング

MCP Inspector でサーバーを直接調べることができます。

npx @modelcontextprotocol/inspector uvx tableau-graphql-mcp

開発

git clone https://github.com/tdries/tableau-graphQL-mcp && cd tableau-graphQL-mcp
uv sync --all-extras
uv run tableau-graphql-mcp                     # run from source
uv run pytest --cov=tableau_graphql_mcp        # tests + coverage (offline; no Tableau needed)
uv run ruff check .                            # lint
uv run ruff format --check .                   # format

同じチェックが CI でも実行されます（Linux／macOS／Windows、Python 3.10～3.13）：ruff check、 ruff format --check、mypy --strict、およびカバレッジの下限を設けた pytest です。このパッケージには PEP 561 の py.typed マーカーが含まれているため、インポートすると型チェッカーで完全な型情報を利用できます。 CodeQL はプッシュごとにスキャンを実行し、週次のファジングジョブ（fuzz/）では読み取り専用ガードを検証します。

コントリビューションを歓迎します。CONTRIBUTING.md と 行動規範 をご覧ください。

ロードマップ

リリース済み：PyPI で公開され、公式の MCP レジストリ に掲載されています。次の予定：

• Data Management を使うオプションの経路：Catalog がある場合に、より詳細な downstreamWorkbooks を提供
• lineage_examples に厳選したクエリテンプレートを追加
• セッション内で同じイントロスペクションを繰り返す場合の、オプションのレスポンスキャッシュ

アイデアや投票は Discussions で歓迎します。

License

MIT © Tim Dries. Built at Biztory.