Excel MCP Server

🚀 Excel MCP サーバ

Excel MCP サーバは、Model Context Protocol (MCP) に基づく Excel ファイル処理サーバです。Excel ファイルの読み取り、書き込み、分析機能を提供します。

✨ 主な機能

• 📖 Excel ファイルの読み取り

  • ワークシートのリストを取得
  • 特定のワークシートのデータを読み取り
  • すべてのワークシートのデータを読み取り

• ✍️ Excel ファイルの書き込み

  • 新しい Excel ファイルを作成
  • 特定のワークシートに書き込み
  • 複数のワークシートをサポート

• 🔍 Excel 構造の分析

  • ワークシートの構造を分析
  • 構造を新しいファイルにエクスポート

• 💾 キャッシュ管理

  • 自動コンテンツキャッシュ
  • 定期的なキャッシュクリーンアップ
  • 手動でのキャッシュクリア

• 📝 ログ管理

  • 自動操作ログ記録
  • 定期的なログクリーンアップ

📦 インストール

Smithery を通じたインストール

Claude Desktop に excel-mcp-server を自動的にインストールするには、Smithery にアクセスし、以下のコマンドを実行してください。

npx -y @smithery/cli install @zhiweixu/excel-mcp-server --client claude

手動インストール

NPM を使用してインストールすることができます。excel-mcp-server は、MCP サーバの設定に以下の内容を追加するだけで自動的にインストールされます。

Windows プラットフォーム：

{
  "mcpServers": {
    "excel": {
        "command": "cmd",
        "args": ["/c", "npx", "--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[アクセス可能な絶対パスを設定]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

その他のプラットフォーム：

{
  "mcpServers": {
    "excel": {
        "command": "npx",
        "args": ["--yes", "@zhiweixu/excel-mcp-server"],
        "env": {
            "LOG_PATH": "[アクセス可能な絶対パスを設定]",
            "CACHE_MAX_AGE": "1",
            "CACHE_CLEANUP_INTERVAL": "4",
            "LOG_RETENTION_DAYS": "7",
            "LOG_CLEANUP_INTERVAL": "24"
        }
    }
}

📚 ドキュメント

環境変数

デフォルト設定

• キャッシュ設定

  • キャッシュの有効期限：1 時間
  • キャッシュのクリーンアップ間隔：4 時間

• ログ設定

  • ログの保持期間：7 日
  • クリーンアップ間隔：24 時間

依存関係

• @modelcontextprotocol/sdk: ^1.7.0
• xlsx: ^0.18.5
• typescript: ^5.8.2

開発依存関係

• @types/node: ^22.13.10
• nodemon: ^3.1.9
• ts-node: ^10.9.2

📄 ライセンス

このプロジェクトは MIT License の下で提供されています。これにより、以下のことが可能です。

• 商用または非商用目的で使用する
• ソースコードを変更する
• 元のコードまたは変更後のコードを配布する

ただし、以下の要件があります。

• 元の著作権表示を保持する
• ソフトウェアの使用によって生じる責任を作者に対して請求しない

詳細なライセンス情報については、LICENSE ファイルを参照してください。