mcp-excel-server

mcp-excel-server

Excel ファイル操作用の Model Context Protocol（MCP）を実装する Node.js サーバーです。

機能

• ファイルの読み取り
• ディレクトリの一覧表示
• ファイルの検索
• Excel の読み取り

注：サーバーが許可する操作は、args で指定されたディレクトリ内に限られます。

🔧 インストール

NPM によるインストール

npm install @qian33/mcp-excel-server

📚 API リファレンス

リソース

• mcp-excel-server の主な操作インターフェース file://system

ツール関数

📖 読み取り操作

• read_file_content
  • ファイルの全内容を読み取ります
  • 入力：path（文字列）
  • テキストファイルには UTF-8 エンコーディングを使用します

🎒書き込み操作

• write_file_content
  • 指定された内容で新しいファイルを作成するか、既存のファイルを上書きします
  • 入力：
    • path（文字列）：書き込み先のファイルの場所
    • content（文字列）：ファイルに書き込む内容
  • テキストファイルには UTF-8 エンコーディングを使用します
  • 書き込みに成功すると確認メッセージを返します

📁 ディレクトリ操作

• list_directory
  • 種別を示す識別子付きでディレクトリの内容を一覧表示します
  • 入力：path（文字列）
  • [FILE] または [DIR] の接頭辞付きでエントリーを返します

🔍 Excel の読み取りと情報取得

• get_excel_content

  • ファイルの Excel 内容を読み取ります
  • 入力：path（文字列）
  • Excel ファイルには UTF-8 エンコーディングを使用します

• get_online_excel_content

  • URL から Excel の内容を取得して読み取ります
  • 入力：path（文字列）：Excel ファイルのオンライン URL
  • Excel データを JSON 配列として返します
  • リモートサーバーでホストされている Excel ファイルの読み取りに便利です

📒 Excel の書き込み

• write_excel_content
  • 指定されたデータで新しい Excel ファイルを作成するか、既存のファイルを上書きします
  • 入力：
    • path（文字列）：Excel ファイルの保存先
    • content（文字列または配列）：Excel ファイルに書き込む JSON データ
      • JSON 文字列またはオブジェクトの直接配列を受け付けます
      • 各オブジェクトは Excel シートの 1 行を表します
  • 「Sheet1」ワークシートを含むブックを自動的に作成します
  • 書き込みに成功すると確認メッセージを返します

🔧 使用ガイド

Claude Desktop との連携

次の設定を claude_desktop_config.json に追加します。

注：ディレクトリを /projects にマウントすると、サンドボックス化できます。ro フラグを追加すると、ディレクトリは読み取り専用になります。

NPX を使用する方法

{
  "mcpServers": {
    "mcp-excel-server": {
      "command": "npx",
      "args": [
        "-y",
        "@qian33/mcp-excel-server",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Bunx を使用する方法

{
  "mcpServers": {
    "mcp-excel-server": {
      "command": "bunx",
      "args": [
        "@qian33/mcp-excel-server",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

VS Code での使用方法

すばやくインストールするには、以下のインストールボタンをクリックしてください……

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加してください。Ctrl + Shift + P を押して Preferences: Open Settings (JSON) と入力すると追加できます。

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

.vscode/mcp.json ファイルでは、mcp キーは不要です。

サンドボックス化されたディレクトリを /projects にマウントして、サーバーに渡すことができます。ro フラグを追加すると、サーバーからディレクトリへの書き込みができなくなります。

NPX

{
  "mcp": {
    "servers": {
      "mcp-excel-server": {
        "command": "npx",
        "args": [
          "-y",
          "@qian33/mcp-excel-server",
          "${workspaceFolder}"
        ]
      }
    }
  }
}

🤝 コントリビューション

コントリビューションを歓迎します！貢献するには、次の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. テストを含めて変更を実装します
4. プルリクエストを送信します

コードがプロジェクトのコーディング規約に準拠し、適切なテストが含まれていることを確認してください。

📜 ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。MIT ライセンスの利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、リポジトリ内の LICENSE ファイルを参照してください。