tablestakes

tablestakes

HTML が乱雑で扱いにくい状態になった表に、LLM がクリーンかつ的確にアクセスできるようにする MCP サーバーです。

問題

GitBook、Notion のエクスポート、CMS プラットフォームなどのツールは、Markdown ファイルへの同期時に表を 1 行の HTML にまとめてしまいます。エディターでは次のように表示されます。

<table><thead><tr><th width="520.11">Requirement</th><th width="122.07">Priority</th><th>Priority 1-2-3</th></tr></thead><tbody><tr><td><strong>1.1</strong> Agent sees only their Salesforce-assigned cases <strong>in the currently selected organization</strong> (case is "assigned" when SF <code>Case.OwnerId</code> matches the agent's linked SF user ID)...</td><td>Must</td><td>1</td></tr></tbody></table>

これは人間には読みづらく、LLM にとっても信頼性に欠けます。モデルは、まとめられた HTML の表の解析に苦労し、セルの境界を頻繁に誤って推測します。また、構造を壊さずに編集することもできません。

tablestakes がこの問題を解決します。 LLM とファイルの間に位置し、読み込み時に表をクリーンなパイプ形式に変換し、保存時には元の形式で書き戻します。これにより、GitBook との互換性、HTML 属性、インライン書式を維持できます。

LLM に表示される内容

検出 — 26 個の表を含むドキュメントを 1 回の呼び出しでスキャンします。

26 tables

T0 pipe 5r 3c v:485f65f7b470 [Cross-Domain Dependencies]
  A:Integration | B:Source | C:Requirements

T2 gitbook 18r 3c v:77a9495fd328 [Case List]
  A:Requirement | B:Priority | C:Priority 1-2-3

T7 gitbook 3r 4c v:d9a9a45a370f [Attachments]
  A:Requirement | B:Priority | C:Dependency | D:Priority 1-2-3

読み込み — 1 行にまとめられた HTML が、クリーンなパイプ形式の表になります。

v:d9a9a45a370f gitbook 3r 4c [Attachments]
A:Requirement | B:Priority | C:Dependency | D:Priority 1-2-3
| Requirement | Priority | Dependency | Priority 1-2-3 |
| --- | --- | --- | --- |
| **5.1** View inbound attachments in-app... | Must | — | 1 |
| **5.2** Send outbound attachments... | Must | Blocked on SF API | 1 |
| **5.3** Attachment file size limits... | Should | — |  |

書き込み — バージョンを確認したうえで、対象セルだけを編集します。

v:5749c94ffb1f

14 文字です。ファイルが更新され、GitBook の HTML 形式が維持され、width 属性もそのまま残ります。

トークン効率

ベースライン：同じファイルに対して Claude Code の組み込みの Read ツールと Edit ツールを使用します。現実的な要件形式の内容（太字の ID、インラインの強調、さまざまな長さのセル）を含む、合成した 18 行・4 列の表で測定しました。

削減の内訳：

• 読み取り（HTML）：省略可能な HTML タグ（<td>、<tr>、<th>、<strong>、width="..."）はすべて単なるオーバーヘッドです。パイプテーブルならマークアップなしで同じ情報を表せます。また、Read ツールは行番号の接頭辞として cat -n も追加します。

• 読み取り（GFM）：行番号の接頭辞と前後のドキュメントのコンテキストを除くことで、わずかに削減できます。表の内容自体はすでに整理されています。

• 書き込み：Edit ツールでは、old_string（ファイル内で一意になるだけのコンテキスト）と new_string（変更後の内容）の両方が必要で、どちらも出力トークンとして生成されます。GFM の場合、old_string は行全体（約190文字）です。tablestakes なら {"row": 0, "column": "B", "value": "Should"}（約18トークン）だけで済みます。

• 検出：tablestakes を使わない場合、LLM は表を見つけるためにファイル全体を読み取ります。list_tables は、メタデータと各表のプレビュー行 1 行を含むコンパクトなインデックスを返します。

• 列の余白がないコンパクトなパイプテーブルを使用します。ImprovingAgents のベンチマークによると、GFM パイプテーブルはトークン数と精度の比率が最も優れています。トークンコストは CSV の 1.24 倍で QA 精度は 51.9% となり、JSON（2.08 倍、52.3%）と YAML（1.88 倍、54.7%）を上回ります。

クイックスタート

Claude Code：

claude mcp add tablestakes -- uvx tablestakes

Codex CLI：

codex mcp add tablestakes -- uvx tablestakes

Gemini CLI：

gemini mcp add tablestakes -- uvx tablestakes

または PyPI から直接インストールします：pip install tablestakes

{
  "mcpServers": {
    "tablestakes": {
      "command": "uvx",
      "args": ["tablestakes"]
    }
  }
}

ツール

検出と読み取り

セル、行、列の操作

すべての書き込みツールには、read_table から取得した version ハッシュが必要です。これにより、ロックを使わずに楽観的同時実行制御を行い、古い内容での上書きを防止します。

サポートされているテーブル形式

GitBook が主な開発の動機ですが、tablestakes は HTML テーブルを含むあらゆる Markdown ドキュメントに対応しています。CMS のエクスポート、Notion のダンプ、Wiki の移行、.md ファイルに手書きされた HTML などを扱えます。

列の指定

列は次の方法で指定できます。

• 文字：「"A"」、「"B"」、「"AA"」（Excel と同様の全単射 26 進法）
• 名前：「"Priority"」（一意である必要があります）
• 複合指定：「"B:Priority"」（曖昧さを解消するために使用）
• インデックス：「"0"」、「"1"」（0 始まり）

開発

make init      # First-time setup: venv + deps + pre-commit hooks
make check     # All checks: format + lint + typecheck + test
make test      # Run tests only
make test-cov  # Tests with coverage report

作者

Dr. Oliver Borchers が開発しました。IU Group のエグゼクティブ AI・オートメーションパートナー兼 AI エンジニアリング責任者です。

ライセンス

Apache-2.0

mcp-name: io.github.oborchers/tablestakes