Tableau Workbook Auditor

tableau-lineage-mcp

ワークブックをお使いのマシンから外に出すことなく、AI アシスタントが Tableau ワークブック内のリネージを読み取れるようにします。

ローカルの Tableau ワークブック（.twbx ／ .twb）を解析し、完全なワークブック監査（未使用フィールド、重複した計算、パフォーマンスに関する指摘）、2 つのバージョン間のセマンティック差分、計算フィールド、パラメーター、フィルター、ワークシート、ダッシュボード、保存済み SQL 文すべての完全なリネージを、Claude、Cursor、その他のあらゆる MCP クライアントに提供する MCP サーバーです。

tableau-lineage.com を支えるものと同じオープンソースの抽出エンジンを、AI アシスタント向けにパッケージ化しました。解析はお使いのマシン上でプロセス内で行われます。アップロードも、サーバーも、アカウントも必要ありません。.twbx を読み取る際は、ワークブックの XML のみを展開し、同梱されているデータ抽出には一切触れません。

アシスタントに尋ねられること

• 「~/Downloads/Sales.twbx を監査して。安全に削除できるものは？」
• 「このダッシュボードの v3 と v4 の間で何が変わって、その影響で何が壊れる？」
• 「[Profit Ratio] が依存しているフィールドは？」
• 「このワークブックの動作が遅いのはなぜ？」
• 「Region でフィルターしているシートと、選択されている値は？」
• 「このワークブックのデータディクショナリを作成して。」

インストール

Claude Desktop（ワンクリック、ターミナル不要）

拡張機能をダウンロードして、ダブルクリックしてください。Claude Desktop がインストールします。 Claude Desktop には独自の Node が同梱されているため、Node のインストールも設定ファイルも必要ありません。

.mcpb を Claude Desktop のウィンドウにドラッグするか、 設定 → 拡張機能 → 詳細設定 → 拡張機能をインストールからインストールすることもできます。

Claude Code

claude mcp add tableau-lineage -- npx -y tableau-lineage-mcp

Claude Desktop（手動、拡張機能より設定を使いたい場合）

claude_desktop_config.json に追加します（設定 → 開発者 → 設定を編集）：

{
  "mcpServers": {
    "tableau-lineage": {
      "command": "npx",
      "args": ["-y", "tableau-lineage-mcp"]
    }
  }
}

Cursor ／その他の MCP クライアント

stdio MCP サーバーに対応するクライアントであれば、同じコマンド npx -y tableau-lineage-mcp を使用できます。

Node.js 18 以降が必要です。

ツール

ツール	説明
audit_workbook	未使用フィールドとパラメーター（理由付きの確信度評価）、重複した計算、重要度と修正方法を示したパフォーマンスに関する指摘
diff_workbooks	2 つのバージョン間のセマンティック差分：追加、削除、名前変更、編集された計算（編集ごとに影響を受ける下流フィールドを表示）、およびパラメーター、フィルター、シート、ダッシュボード、データソース、SQL
analyze_workbook	概要：統計、データソース、種類別の計算フィールド、パラメーター、未加工フィールド
list_calculated_fields	数式、種類、直接の依存関係を含むすべての計算。部分文字列による任意のフィルターに対応
get_field	1 つのフィールドの詳細情報。フィールドを直接使用しているものすべてを含む
trace_dependencies	未加工列とパラメーターまでの上流ツリー、および推移的な下流への影響
list_parameters	値、データ型、許可された値、および各パラメーターを使用するフィールドを含むパラメーター
get_lineage_graph	ノードとエッジの JSON として、依存関係グラフ全体を表示
list_sql_queries	カスタム SQL（クエリ全文）、Initial SQL、パラメーター付きの保存済みストアドプロシージャ参照、および RAWSQL_* 計算。それぞれ接続先も表示
list_filters	ワークシート間で重複を除いたすべてのフィルター：フィールド、種類、コンテキストフィルターかどうか、メンバーの選択と範囲、および by_worksheet の内訳
list_worksheets	使用するフィールド（キャプションを解決済み）と適用するフィルターを含む、すべてのワークシート

すべてのツールは、ローカルの .twbx または .twb ファイルへの path を受け取ります。フィールド名では大文字と小文字が区別されず、角括弧は省略できます。Profit Ratio と [profit ratio] はどちらも解決されます。

プライバシーポリシー

ポリシー全文：https://github.com/andey0Saikiran/tableau-lineage/blob/main/PRIVACY.md

収集する情報：ありません。 このサーバーは、いかなる種類のネットワークリクエストも行いません。明示的に渡されたワークブックのパスのみを読み取り、お使いのマシン上でメモリ内で解析し、起動した MCP クライアントに結果を返します。他のファイル、会話履歴、アシスタントのメモリを読み取ることはなく、ディスクへの書き込みも行いません。

保存と保持：ありません。 ワークブックのデータは呼び出し中のみメモリに保持され、プロセスの終了時に破棄されます。サーバー、データベース、ログ記録はありません。

第三者：ありません。 ただし、ツール呼び出しの 結果（フィールド名、数式、監査結果）は、回答を生成できるよう、質問先として選んだ AI アシスタントに返されます。ワークブックファイル自体が外部に送信されることはありません。その会話には、利用するアシスタント独自のプライバシーポリシーが適用されます。

お問い合わせ先： https://github.com/andey0Saikiran/tableau-lineage/issues · セキュリティに関する報告：https://github.com/andey0Saikiran/tableau-lineage/security/advisories/new

仕組み

• ワークブックはローカルディスクから読み取られ、Node プロセス内で解析されます。外部に送信される情報はありません。
• 未使用のフィールドは、確信度とともに 候補 として報告されます。安全に削除できることが保証された一覧として報告されることはありません。ワークブックファイルだけでは、フィールドがあらゆる場所で参照されていないことを証明できないためです。削除する前に理由を確認してください。
• .twbx パッケージでは、.twb の XML エントリのみを展開します。パッケージに含まれるデータ抽出ファイル（.hyper / .tde）は完全にスキップされます。
• アナリティクス、テレメトリ、ネットワーク呼び出しは一切ありません。

このパッケージはオープンソースなので、コードですべてを確認できます。

UI を使いたい場合

同じエンジンが、無料のウェブアプリ tableau-lineage.com として動作します。.twbx をドラッグするだけで、監査結果、インタラクティブなリネージグラフ、検索可能なデータディクショナリ、バージョン比較を、100% ブラウザー内で利用できます。

開発

git clone https://github.com/andey0Saikiran/tableau-lineage
cd tableau-lineage/mcp
npm install
npm test        # builds, then runs an end-to-end JSON-RPC smoke test

ライセンス

MIT © Sai Kiran Andey