EXCEL操作MCPサーバー

January 25, 2025 · View on GitHub

このサーバーは、ローカルのEXCELファイルを操作するためのMCPツールを提供します。

動作環境

Node.js: 18.x 以上
npm: 9.x 以上
Excelファイル形式: .xlsx
対応OS: Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+)

インストール手順

1. リポジトリのクローン

git clone git@github.com:virtuarian/excel-server.git
cd excel-server

2. 依存関係のインストールとビルド

npm install
npm run build

3. MCPサーバの設定

▼ Clineから利用する場合

MCP Servers を開く
Edit MCP Settings をクリック
以下のexcelのエントリーを追加する

{
  "mcpServers": {
    "excel": {
      "command": "node",
      "args": ["/cloned-path/build/index.js"], // GithubをCloneしたフォルダ
      "env": {},
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

※ あるいは手動でjsonファイルを開いて修正してください

使用方法

EXCELファイルの読み込み

{
  "server_name": "excel",
  "tool_name": "read_excel",
  "arguments": {
    "filePath": "/path/to/file.xlsx",
    "sheetName": "Sheet1",
    "range": "A1:C10"
  }
}

EXCELファイルへの書き込み

{
  "server_name": "excel",
  "tool_name": "write_excel",
  "arguments": {
    "filePath": "/path/to/file.xlsx",
    "sheetName": "Sheet1",
    "data": [
      ["A1", "B1", "C1"],
      ["A2", "B2", "C2"]
    ]
  }
}

新しいシートの作成

{
  "server_name": "excel",
  "tool_name": "create_sheet",
  "arguments": {
    "filePath": "/path/to/file.xlsx",
    "sheetName": "NewSheet"
  }
}

新しいEXCELファイルの作成

{
  "server_name": "excel",
  "tool_name": "create_excel",
  "arguments": {
    "filePath": "/path/to/new_file.xlsx",
    "sheetName": "Sheet1"  // オプション、デフォルトは"Sheet1"
  }
}

注意事項

ファイルパスは絶対パスで指定してください
シート名を指定しない場合、最初のシートが操作対象になります
範囲指定は"A1:C10"のような形式で指定できます
create_excelで既存のファイルパスを指定するとエラーになります

作成者

作成者：virtuarian

ライセンス

このMCPサーバーはMITライセンスの下で提供されています。このライセンスにより、ソフトウェアの使用、改変、配布が自由に行えますが、MITライセンスの条件に従う必要があります。詳細については、プロジェクトリポジトリのLICENSEファイルを参照してください。

目次