オフィスMCP v1.0.5
AI モデルによって Microsoft アプリケーションを制御する最もわかりやすく無料の方法。
オフィス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"
}
}
}
使用法
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 ツールを使用してコードを実行し、コードを使用してそれらを制御します。
- 今後さらに多くのツールが追加される予定です。
発達
git clone https://github.com/officemcp/officemcp