Excel MCP Server

AIエージェント（Claude、ChatGPT、Copilotなど）がExcelファイルを自動操作できるModel Context Protocol (MCP) サーバーです。

🎯 できること

このMCPサーバーを使うと、AIエージェントに自然言語で指示するだけで、以下のようなExcel操作が自動化できます：

• 📊 データ入力・編集: セルや範囲に値を設定、取得

• 📝 ワークブック管理: 新規作成、シート追加、情報取得

• 🎨 書式設定: フォント、色、罫線などの装飾

• 🔢 数式・計算: セルに数式を追加して自動計算

• 🔍 データ検索: ワークシート内のデータを検索

• 💾 データ出力: ExcelシートをCSVファイルにエクスポート

例: 「売上データを分析して、月別の合計を計算し、グラフ用のシートを作成して」と指示すれば、AIが自動的にExcelファイルを操作します。

Related MCP server: Excel MCP Server

📚 詳細ガイド

初心者の方は guide/ ディレクトリの詳細ガイドを参照してください：

• 📖 メインガイド - プロジェクト全体の概要

• 🎓 MCP基礎知識 - MCPとは何か、仕組みの理解

• ⚙️ セットアップ手順 - 環境構築方法

• 🚀 使用方法 - 実際の使い方と例

• 🔧 ツール詳細 - 各Excel操作ツールの詳細

• 🛠️ トラブルシューティング - よくある問題と解決方法

• 📋 サンプル集 - 実用的な使用例集

🚀 セットアップ手順

1. 必要な環境

• Node.js (v16以降)

• Windows、macOS、またはLinux

2. インストール

# ディレクトリ移動
cd excel_mcp_server

# 依存関係をインストール
npm install

# ビルド
npm run build

3. VS Code Copilotとの連携設定

VS CodeでCopilotと連携する場合、mcp.jsonファイルに設定を追加します。

設定ファイルの場所:

• Windows: %APPDATA%\Code\User\mcp.json (安定版) または %APPDATA%\Code - Insiders\User\mcp.json (Insiders版)

• macOS: ~/Library/Application Support/Code/User/mcp.json または ~/Library/Application Support/Code - Insiders/User/mcp.json

• Linux: ~/.config/Code/User/mcp.json または ~/.config/Code - Insiders/User/mcp.json

設定内容:

{
  "servers": {
    "excel-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/path/to/excel_mcp_server/dist/index.js"]
    }
  }
}

重要: C:/path/to/excel_mcp_server/dist/index.js は、実際のプロジェクトの dist/index.js への絶対パスに置き換えてください。

4. 動作確認

VS Codeを再起動後、Copilotに以下のように話しかけてみてください：

「ExcelファイルC:/test/sample.xlsxを作成して、Sheet1を追加し、A1セルに"Hello Excel"と入力してください」

💡 使用例

基本的な操作

1. 新しいExcelファイルを作成

   「C:/reports/monthly.xlsxという新しいExcelファイルを作成して」

2. データを入力

   「Sheet1のA1からC3の範囲に、商品名、価格、在庫数の表を作成して」

3. 書式を設定

   「A1セルを太字にして、背景色を黄色にして」

4. 数式で計算

   「D列に合計を計算する数式を追加して」

より高度な使い方

詳細な使用例は サンプル集 を参照してください。

🔧 提供される機能

このMCPサーバーは以下のExcel操作ツールを提供します：

ワークブック・ワークシート操作

• create_workbook - 新しいExcelワークブックを作成

• get_workbook_info - ワークブックの詳細情報を取得（シート一覧など）

• add_worksheet - 既存のワークブックにワークシートを追加

セル・範囲操作

• set_cell_value - 単一のセルに値を設定

• get_cell_value - 単一のセルの値を取得

• set_range_values - 複数セルに一括でデータを設定（表形式データに便利）

• get_range_values - 複数セルのデータを一括取得

書式設定

• format_cell - セルの書式を設定（フォント、背景色、罫線など）

数式・計算

• add_formula - セルに数式を追加（SUM、AVERAGEなど）

データ操作

• find_data - ワークシート内で特定のデータを検索

出力

• export_to_csv - ワークシートをCSVファイルにエクスポート

詳細は ツール詳細ガイド を参照してください。

🛠️ トラブルシューティング

問題が発生した場合は、トラブルシューティングガイド を確認してください。

📄 ライセンス

ISC

開発者向け情報

開発環境のセットアップ

開発モードで実行：

npm run dev

プロジェクト構造

プロジェクト構造

• 言語: TypeScript

• ランタイム: Node.js

• MCP SDK: @modelcontextprotocol/sdk

• Excel ライブラリ: ExcelJS

• スキーマ検証: Zod

デバッグ

VS Codeでのデバッグ設定は .vscode/mcp.json に含まれています。