Spreadsheet MCP

🚀 電子表格 MCP サーバー (@zephyr - mcp/spreadsheet)

このプロジェクトは、TypeScript をベースにしたモデルコンテキストプロトコル (MCP) サーバーです。LLM または API 統合を通じて、CSV/XLSX 電子スプレッドシートファイルの表示、フィルタリング、ソート、更新を行うことができます。

✨ 主な機能

• 電子スプレッドシートの情報を表示し、行をプレビューする
• 列と条件に基づいて行をフィルタリングする
• 列で行をソートする (昇順/降順)
• 既存の XLSX ファイルに新しいワークシートを追加するか、新しいファイルを作成する
• CSV と XLSX ファイルをサポートする
• 表示/フィルタリング/ソートの結果を 2 次元配列を含む JSON 文字列で返す
• 技術スタック: TypeScript, fastmcp, papaparse, xlsx, zod

📦 インストール

このパッケージは npx で直接実行するように設計されています。通常の使用ではインストールする必要はありません。

前提条件

• Node.js v18+ (LTS バージョンを推奨)

MCP サーバーの起動

stdio モードでサーバーを起動します (Cline などのツールとの統合に使用):

npx @zephyr-mcp/spreadsheet

サーバーが起動し、標準入出力を通じて MCP コマンドを待ち受けます。

🚀 クイックスタート

開発環境のセットアップ

1. リポジトリをクローンします:

git clone https://github.com/your-username/spreadsheet-mcp.git # あなたのリポジトリ URL に置き換えてください
cd spreadsheet-mcp

2. 依存関係をインストールします:

npm install

開発

3. 開発サーバーを起動します:

npm run dev

💻 使用例

基本的な使用法

# サーバーを stdio モードで起動する
npx @zephyr-mcp/spreadsheet

高度な使用法

# 開発サーバーを起動する
npm run dev

📚 ドキュメント

テスト

npm test

パッケージの公開

1. パッケージのバージョンを更新します:

npm version major/minor/patch

2. 変更をコミットし、リモートリポジトリにプッシュします。
3. ビルドして公開します:

npm run build
npm publish

プロジェクト構造

- src/
  ├── server.ts            # MCP サーバーのエントリーポイント、ツールの登録
  └── spreadsheetUtils.ts  # 電子スプレッドシートの解析、フィルタリング、フォーマット、書き込み
- tests/
  └── server.test.ts

サンプルツール

• view_spreadsheet: ファイル情報を表示し、指定した行数をプレビューします。ファイル情報とプレビューデータ (2 次元配列) を含む JSON 文字列を返します。rows パラメータでプレビューする行数を指定します (0 はヘッダーのみ、デフォルトは 10、最大制限はありません)。
• filter_spreadsheet: 列と条件に基づいて行をフィルタリングします。フィルタリング結果 (2 次元配列) を含む JSON 文字列を返します。rows パラメータで返す最大行数を指定します (デフォルトはすべての一致行、最大制限はありません)。
• sort_spreadsheet: 列で行をソートします。ソート結果 (2 次元配列) を含む JSON 文字列を返します。rows パラメータで返す最大行数を指定します (デフォルトはすべての行、最大制限はありません)。
• update_spreadsheet_with_new_sheet: データを XLSX ファイルの新しいワークシートに書き込みます。

📄 ライセンス

MIT License © 2025 Zephyr

作者

Zephyr