Cellpilot MCP

🚀 CELLPILOT MCP

強力なModel Context Protocol (MCP)サーバーであり、GitHub CopilotのようなAIアシスタントがExcelファイル（.xlsxおよび.xls）を読み書きし、操作することを可能にします。

C#とNPOIライブラリを使用して構築されたこのMCPサーバーは、一連の直感的なツールを通じて包括的なExcel機能を提供します。

✨ 主な機能

📁 ファイル操作

• GetExcelFileInfo - シート名、行数、列数などのファイルメタデータを取得します。
• CopyExcelFile - Excelファイルを新しい場所にコピーします。
• ListSheets - ワークブック内のすべてのシート名を一覧表示します。
• CreateWorkbook - 新しいExcelワークブック（.xlsxまたは.xls）を作成します。

📖 データの読み取り

• ReadCell - 特定のセルの値を読み取ります。
• ReadRange - セルの範囲を2次元配列として読み取ります。
• GetSheetData - シート内のすべてのデータを取得します。
• GetCellFormula - セルから数式を取得します。

🔍 検索

• SearchInSheet - シート内で値を検索します。
• SearchInWorkbook - ワークブック内のすべてのシートを検索します。
• SearchInColumn - 特定の列内を検索します。
• SearchWithRegex - 正規表現を使用して検索します。
• SearchNumericRange - 範囲内の数値を持つセルを検索します。
• SearchDateRange - 範囲内の日付を持つセルを検索します。

✍️ データの書き込み

• WriteCell - セルに値を書き込みます。
• WriteRange - 2次元配列のデータを書き込みます。
• SetCellFormula - セルに数式を設定します。
• ClearRange - セルの範囲から内容をクリアします。

📊 シート管理

• CreateSheet - 新しいシートを作成します。
• RenameSheet - 既存のシートを改名します。
• DeleteSheet - ワークブックからシートを削除します。
• CopySheet - ワークブック内でシートを複製します。

🔧 セルと行/列の操作

• InsertRow / DeleteRow - 行を追加または削除します。
• InsertColumn / DeleteColumn - 列を追加または削除します。
• MergeCells / UnmergeCells - セル範囲を結合または解除します。
• ListMergedRegions - シート内のすべての結合領域を一覧表示します。
• AutoSizeColumn - 列幅を内容に合わせて自動調整します。
• SetColumnWidth - 特定の列幅を設定します。

📦 インストール

NuGet.orgからのインストール

dnxコマンドを使用してIDEでMCPサーバーを構成します。

VS Code - .vscode/mcp.jsonを作成します：

{
  "servers": {
    "CellPilotMCP": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "CellPilotMCP",
        "--version",
        "0.0.1",
        "--yes"
      ]
    }
  }
}

Visual Studio - 同じ構造でソリューションディレクトリに.mcp.jsonを作成します。

ソースからのインストール（ローカル開発）

{
  "servers": {
    "CellPilotMCP": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<プロジェクトディレクトリのパス>"
      ]
    }
  }
}

💻 使用例

構成が完了すると、AIアシスタントにExcel操作を依頼できます。

• "my-file.xlsxのSheet1のすべてのデータを読み取る"
• "名前、メールアドレス、電話番号の列を持つ新しいExcelファイルを作成する"
• "ワークブック内で'Total'を含むすべてのセルを検索する"
• "セルC10にC1:C9を合計するSUM数式を書き込む"
• "見出し行としてセルA1からD1を結合する"
• "Sheet1のすべての列幅を自動調整する"

📚 ドキュメント

このMCPサーバーはModelContextProtocol C# SDKを使用しています。

MCPのリソース:

• 公式ドキュメント
• プロトコル仕様
• GitHub Organization

IDEの構成:

• VS CodeでMCPサーバーを使用する（プレビュー）
• Visual StudioでMCPサーバーを使用する（プレビュー）

📄 ライセンス

MIT