csvto-mcp について
csvto-mcpは、AIアシスタントで構造化データを扱う人向けのローカルファイル変換MCPサーバーです。CSV、JSON、Excelに対応し、ファイルをアップロードしたり内容をモデルのコンテキストに渡したりせず、変換結果を元ファイルの隣に保存します。
主な機能
- 01CSV・JSON・Excelファイルの変換
- 02ファイルのローカル処理
- 03元ファイルの隣への結果保存
- 04列単位での型推定
- 05変換で変わる値の保持
活用シーン
- 01ローカルCSVファイルのExcel変換
- 02JSONデータの表計算向け変換
- 03変換時の先頭ゼロと数値精度の維持
MCP 対応
csvto-mcpは、MCPクライアントにローカルファイル変換ツールを提供します。クライアントがファイルパスを渡すと、ファイル内容をアップロードしたりモデルのコンテキストに送ったりせず、ローカルに変換結果を保存します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
10掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| format | enum | いいえ | 既定ではファイル拡張子から判定します。csv | json | xlsx |
| has_header | boolean | いいえ | 先頭行を列名として扱います。既定値は true です。 |
| input_path | string | はい | このマシン上にあるソースファイルの絶対パス。 |
詳細
csvto
データがすでにある場所で、CSV、JSON、Excel を変換します。
csvto-mcp— MCP サーバーです。AI アシスタントにファイルパスを指定すると、ローカルで変換し、結果をそのファイルの隣に書き込みます。アップロードは行われず、ファイルの内容がモデルのコンテキストを通過することもありません。@csvto/core— 変換エンジンです。DOM、fs、ネットワークに依存しないため、同じテスト済みのコードをブラウザー、ローカルの MCP プロセス、サーバーで実行できます。
同じエンジンが csvtosite.com のブラウザーツールにも使われており、変換はクライアント側で行われ、ファイルがアップロードされることもありません。
MCP サーバーをインストールする
claude mcp add csvto -- npx -y csvto-mcp
または、任意の MCP クライアントの設定に追加します。
{
"mcpServers": {
"csvto": { "command": "npx", "args": ["-y", "csvto-mcp"] }
}
}
Node 18 以降が必要です。ツールの一覧と動作については、packages/mcp/README.md をご覧ください。
型はセル単位ではなく、列ごとに推論されます
ここが重要なポイントであり、多くのコンバーターが気付かれないままデータを破損させる箇所です。列内のすべての値が往復変換後も完全に同じ場合に限り、その列を数値に変換します。値が一つでも変わる場合は、列全体をテキストのままにします。
01234は1234にならず、先頭のゼロを保持します- 16 桁の口座番号は
1.23457E+14にならず、そのまま保持されます 1250.50は1250.5にならず、末尾のゼロを保持します- 列が数値と文字列の混在になることはありません
テストで確認済みです。01234 は CSV → xlsx → CSV の往復変換後もそのまま保持されます。
開発
npm install
npm test # 49 tests
npm run build
packages/core は環境に依存しない状態を保つ必要があります。window、fs、fetch は使用できません。この制約により、一つのテスト済みエンジンですべての実行環境に対応できます。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。