Xlsm MCP Server

🚀 📊 MCPサーバー（Excelファイル（マクロ付き）(.xlsm)用）

このサーバーは、Model Context Protocol (MCP) を実装し、マクロ付きのExcelファイル (.xlsm) を処理するためのものです。stdioプロトコルを使用して通信するため、Claude Desktop、Cursor、WindsurfなどのMCPクライアントに簡単に統合できます。

🚀 クイックスタート

MCP（Model Context Protocol）は、言語モデルが外部ツールと相互作用するためのプロトコルです。このサーバーを通じて、Claudeや他のAIアシスタントは自然にマクロ付きのExcelファイルを処理でき、データ分析やオフィス自動化タスクでの能力を拡張できます。

✨ 主な機能

• マクロ付きのExcelファイル (.xlsm) の作成と操作
• ワークシートデータの読み取りと書き込み
• ワークシートの管理（作成、削除、名前変更）
• VBAマクロの一覧表示と情報取得
• セル範囲の書式適用
• Python 3.10+ との互換性
• 仮想環境や最新のMCPクライアントへの簡単な統合

📦 インストール

pipを使用する場合

pip install xlsm-mcp-server

uvを使用する場合（推奨）

uv venv
.venv\Scripts\activate
uv pip install -r requirements.txt

💻 使用例

基本的な使用法

# サンプルコード：Excelファイルからデータを読み取る
import xlsm_mcp as mcp
mcp.read_data_from_excel("example.xlsx")

高度な使用法

# サンプルコード：Excelワークシートにデータを書き込む
import xlsm_mcp as mcp
data = {
    "A": [1, 2, 3],
    "B": ["a", "b", "c"]
}
mcp.write_data_to_excel("example.xlsx", data)

📚 ドキュメント

直接実行する場合

python -m xlsm_mcp

または、仮想環境では：

.venv\Scripts\python.exe -m xlsm_mcp

Claude Desktop、Cursor、またはWindsurf用に設定する場合

以下の内容を設定ファイル（例：settings.json）に追加します。

"mcpServers": {
  "xlsm": {
    "command": "python",
    "args": ["-m", "xlsm_mcp"],
    "transport": "stdio"
  }
}

• 一部のクライアントでは "transport": "stdio" を省略できますが、最適な互換性を確保するために残すことをおすすめします。
• 仮想環境を使用している場合は、"python" をPython実行ファイルの実際のパスに置き換えてください。

高度なパラメータ

"args" セクションにカスタムパラメータを追加することで、必要に応じてサーバーの動作を調整できます。例えば：

"args": ["-m", "xlsm_mcp", "--log-level", "DEBUG"]

🛠️ 利用可能なツール

• read_data_from_excel: Excelファイルからデータを読み取る
• write_data_to_excel: データをExcelワークシートに書き込む
• create_new_workbook: マクロをサポートする新しいExcelファイルを作成する
• create_new_worksheet: 既存のファイルに新しいワークシートを追加する
• get_workbook_metadata: ファイルのメタデータ（マクロ関連情報を含む）を取得する
• list_macros_in_workbook: ファイル内のすべてのマクロを一覧表示する
• get_macro_details: 特定のマクロの詳細情報を取得する
• format_cell_range: セル範囲に書式を適用する

⚠️ 重要提示

• Python 3.10以上がインストールされていることを確認してください。
• 仮想環境を使用する場合は、環境をアクティブ化してからサーバーを実行してください。
• 複雑なマクロファイルを使用する場合、パフォーマンスの問題が発生する可能性があります。テスト後に最適化することをおすすめします。

作者: Orlando Ospino (orlando2019)

以上の内容が役立つことを願っています。何か質問があれば、作者にお問い合わせください。