オフィスMCP v1.0.5

Name: OfficeMCP
Author: OfficeMCP

AI モデルによって Microsoft アプリケーションを制御する最もわかりやすく無料の方法。

PyPI - バージョン

オフィスMCP

OfficeMCPサーバーは、Windows OSのCOMインターフェースを介してMicrosoft Officeアプリケーション（Word、Excel、PowerPoint、Access、OneNote、Visio、Project、WPS.word、Wps.powerpoint、wps.excelなど）をAIが自動化できるように設計されています。Linux/MacOSでは動作しません。

警告する

OfficeMCPはPythonの使用を制限していませんので、ご注意ください。特に、Aiモデルによって生成されたPythonコードを実行するためのツールRunPython(...)があります。これはOfficeMCPの最も優れた点の一つでもあります。ただし、AIモデルがコンピュータに悪影響を与えないことを保証することはできません。また、いかなる責任も負いかねます。

システム要件

Windowsシステム
Python 3.1以上がインストールされている
uvがインストールされたらシェルウィンドウを開いてコマンドを実行します
pip インストール uv

OfficeMCPのインストール方法

OfficeMCP をインストールするには、2 つの方法または 2 つのモードがあります (同時に使用することもできます)。

1. OfficeMCP を stdio サーバーとして使用します。

1 つの MCP クライアントモードに 1 つの OfficeMCP サーバー
次の設定を、vscode の場合は MCP.json ファイル、他の AI IDE の場合は適切な場所に配置しましょう。

{ "mcpServers": { "OfficeMCP": { "type": "stdio", "command": "uvx", "args": [ "officemcp" ] } } }

2. OfficeMCP を SSE サーバーとして使用します。

マルチ MCP クライアントモード用の 1 つの OfficeMCP サーバー
ポートとホストは自由に変更できます
これは、OfficeMCP サーバーを使用するための推奨される方法です。

ステップ1:

シェルまたは Power Shell で 1 つのコマンドを実行します。

uvx オフィスmcp sse

Mcp サーバーの URL は次のようになります: " http://127.0.0.1:8888/sse " または " http://127.0.0.1:8888/sse " デフォルトの作業フォルダーは D:@officemcp です

または以下のようなもの

uvx officemcp sse --port 7777 --host 127.0.0.8 --folder D:\myfolder

「url」は「 http://127.0.0.8:7777/sse 」になります

ステップ2:

次の設定を、vscode の場合は MCP.json ファイル、他の AI IDE の場合は適切な場所に配置しましょう。

{ "servers": { "OfficeMCP": { "url": "http://127.0.0.1:8888/sse" } } }

または

{ "servers": { "OfficeMCP": { "url": "http://{your_host}:{your_port}/sse" } } }

Related MCP server: Office Word MCP Server

使用法

AI IDE では、OfficeMCP サーバー経由で Office アプリケーションを制御するように AI モデルに要求できます。

AI モデルに新しい Office アプリケーションを開くように指示します。AI モデルは OfficeMCP サーバーにリクエストを送信し、OfficeMCP サーバーは新しい Office アプリケーションを開きます。
現在の Office アプリケーションで実行したい操作を AI モデルに指示します。AI モデルはリクエストを分析し、OfficeMCP サーバーのツールを呼び出してリクエストを実行します。

ツールリファレンス

ツール:

AvailableApps(): コンピューターに Microsoft Office アプリケーションがインストールされているかどうかを確認します。
RunningApps(): 現在実行中の Office アプリケーションの一覧を取得します。
IsAppAvailable(...): 特定の Office アプリケーションがインストールされているかどうかを確認します。
起動(...): 新しい Office アプリケーションを起動し、その表示設定を設定します。
Visible(...): 指定された Office アプリケーションの表示を True または False に設定します。
Quit(...): 指定された Office アプリケーションを終了します。
Demonstrate(): OfficeMCP 自動化機能のデモンストレーションを実行します。
Speak(...): 渡された文字列を読み上げます。
Beep(...): ビープ音を鳴らします。
DefaultFolder(...): OfficeMCP ルート作業フォルダを返します。デフォルトは ("D:\OfficeMCP") です。
IsFileExists(sub_path): OfficeMCP ルートフォルダーにファイルが存在するかどうかを確認します。
DownloadImage(...): 指定された URL から画像をダウンロードし、指定されたパスに保存します。
RunPython(codes,data): OfficeMCP サーバーコンテキストで Python コードを実行します。
- これはOfficeMCPサーバーで最も強力なツールです。AIはこのツールを使用して、Officeアプリケーションの自動化など、サーバーでサポートされているあらゆる操作を実行できます。
- Python コードで使用できるオブジェクト「Officer」があります。たとえば、 Officer.Excelは現在の Excel com アプリケーションを保持します。そのほか、Officer.Word、Officer.Powerpoint、Officer.Access、Officer.OneNote、Officer.Visio、Officer.Project などがあります。WPS Word の場合は Office.Kwps、WPS Excell の場合は Office.Ket、WPS PowerPoint の場合は Office.Kwpp です。
- Python コードで使用できる RunPython(...) の戻り値としてオブジェクト「output」があり、output="run python sccessed" のように、独自の戻り結果を出力に配置すると、RunPython は AI モデルに「run python sccessed」を返します。
- Officer.Visio を使用して新しい Visio ドキュメントを作成し、次に Officer.Visio.ActivePage を使用してアクティブページを取得し、Officer.Visio.ActivePage.DrawRectangle(...) を使用してページ上に四角形を描画することができます。
- Officer.Excel を使用して新しい Excel ドキュメントを作成し、次に Officer.Excel.ActiveSheet を使用してアクティブシートを取得し、Officer.Excel.ActiveSheet.Cells(...) を使用してセルを取得し、Officer.Excel.ActiveSheet.Cells(...).Value = "hello" を使用してセルの値を設定できます。
- RunPython ツールを使用してコードを実行し、コードを使用してそれらを制御します。
今後さらに多くのツールが追加される予定です。