xlsx-audit-mcp

xlsx-audit-mcp

Excel ワークブックを監査する MCP サーバーです。他の Excel MCP サーバーはデータの読み書きを行いますが、このサーバーは モデル をレビューします。

• 「Summary シートの Total セルには何が影響していますか？」 — 先行セルの追跡
• 「この前提を変更したら、何が壊れますか？」 — SUM(A1:A40) のような範囲を介して値を利用するセルも含めた依存セルの追跡
• 「このワークブックを監査して」 — 具体的な参照経路を示す循環参照、揮発性関数（INDIRECT、OFFSET、NOW、RAND など）、数式内に埋め込まれたハードコードの定数、外部ワークブックへのリンク、結合セル、極端に長い数式

スプレッドシートのミスは、非常に大きな損失につながることで知られています。これは、監査人が手作業で行う「先行セルの追跡」を、ワークブック全体を一度に対象として LLM に提供するものです。ローカルファイルのみを対象とし、データがマシンの外部に送信されることはありません。

クイックスタート

Claude Code

claude mcp add xlsx-audit -- npx -y xlsx-audit-mcp

Claude Desktop — claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "xlsx-audit": {
      "command": "npx",
      "args": ["-y", "xlsx-audit-mcp"]
    }
  }
}

次に、「C:\models\budget-2026.xlsx を監査して、脆弱に見える箇所を教えてください。」 と依頼します。

ツール

ツール	説明
workbook_overview	シート、サイズ、数式の数、定義済みの名前、外部リンク
list_formulas	アドレスとキャッシュ値を含む数式。INDIRECT、VLOOKUP などで絞り込み可能
trace_cell	1 つのセルの数式、値、先行セル、依存セル（直接参照および範囲経由）
audit_workbook	モデル全体のリスクを順位付けしたレポート

仕組み

• 実際の数式を理解する参照トークナイザーです。文字列リテラルは最初に除外されるため、INDIRECT("A1") 内の "A1" は参照として扱われません。また、関数名との衝突（LOG10(...) 内の G10 はセルではありません）、$ による絶対参照、引用符で囲まれたシート名（'My Data'!A1）、範囲にも対応しています。
• 共有数式をセルごとに展開します。 Excel は入力済みの数式をオフセット方式で一度だけ保存します。ローダーはセルごとに数式を変換し（相対参照はシフトし、絶対参照は維持します）、依存関係のクエリで各セルの実際の計算内容を確認できるようにします。
• 範囲はストレージ用に展開しません。依存セルのクエリでは範囲包含テストを使用し、循環検出では範囲の展開数に上限を設けます（SUM(A:A) によってグラフが爆発的に拡大することはありません。上限に達した範囲は黙って破棄せず、レポートに表示します）。
• 数式は評価しません。 スプレッドシートエンジンに依存せず、ファイルに保存されたキャッシュ値を表示します。

既知の制限事項：R1C1 表記と構造化テーブル参照（[@Column]）はカウントされますが、グラフには解決されません。

開発

npm install
npm test                 # offline tests — synthetic workbooks built in-suite
npm run build            # tsc → dist/
node scripts/smoke.mjs   # end-to-end: generates a workbook, drives the server over stdio

アーキテクチャ：src/xlsx.ts（zip と XML からワークブックモデルへの変換）および src/formulas.ts（トークナイザー、グラフ、問題点の検出）は純粋なロジックです。MCP の接続処理は src/index.ts が担います。

ライセンス

MIT