Office MCP Server

Office MCP サーバー

Office MCP Server は、Word、Excel などのファイルに関する AI エージェントからのリクエストを管理および処理するために設計された、Java ベースの非公式な Model Context Protocol（MCP）サーバーです。

フレームワーク

このプロジェクトは、軽量で高性能なマイクロサービスの構築に特化した、Kubernetes ネイティブの Java フレームワークである Quarkus を使用して構築されています。Quarkus は起動時間の短縮とメモリ使用量の削減を実現するため、クラウドネイティブアプリケーションに最適です。

サポートされているメソッド

このサーバーは、次の MCP ツールとリソースをサポートしています。

Excel の機能

• ツール：ファイル名を取得：Excel ファイルのファイル名を取得します。
  • 引数：filename - Excel ファイルの名前。
• ツール：Excel ワークブックを作成：新しい Excel ワークブックを作成します。
  • 引数：filepath - 新しい Excel ワークブックを作成するパス。
• ツール：Excel シートを作成：Excel ワークブックに新しいシートを作成します。
  • 引数：
    • filepath - Excel ワークブックへのパス。
    • sheetName - 新しいシートの名前。
• ツール：Excel の行を追加：Excel シートに行を追加します。
  • 引数：
    • filepath - Excel ワークブックへのパス。
    • sheetName - シートの名前。
    • rowData - 新しい行のデータ。
• ツール：Excel のセルを読み取る：Excel シートのセルを読み取ります。
  • 引数：
    • filepath - Excel ワークブックへのパス。
    • sheetName - シートの名前。
    • rowNum - 行番号（0 始まり）。
    • colNum - 列番号（0 始まり）。
• ツール：Excel ワークブックを閉じる：Excel ワークブックを閉じます。
  • 引数：filepath - Excel ワークブックへのパス。
• ツール：Excel のシート数を取得：Excel ワークブックのシート数を取得します。
  • 引数：filepath - Excel ワークブックへのパス。
• ツール：Excel の行数を取得：シートの行数を取得します。
  • 引数：
    • filepath - Excel ワークブックへのパス。
    • sheetName - シートの名前。
• ツール：Excel の列数を取得：シートの列数を取得します。
  • 引数：
    • filepath - Excel ワークブックへのパス。
    • sheetName - シートの名前。

Word の機能

• ツール：Word ドキュメントを作成：新しい Word ドキュメントを作成します。
  • 引数：filepath - 新しい Word ドキュメントを作成するパス。
• ツール：Word ドキュメントにテキストを追加：Word ドキュメントにテキストを追加します。
  • 引数：
    • filepath - Word ドキュメントへのパス。
    • text - 追加するテキスト。

PowerPoint の機能

• ツール：PowerPoint プレゼンテーションを作成：新しい PowerPoint プレゼンテーションを作成します。
  • 引数：filepath - 新しい PowerPoint プレゼンテーションを作成するパス。
• ツール：PowerPoint にスライドを追加：PowerPoint プレゼンテーションに新しいスライドを追加します。
  • 引数：filepath - PowerPoint プレゼンテーションへのパス。
• ツール：PowerPoint のスライドにテキストを追加：PowerPoint プレゼンテーションの特定のスライドにテキストを追加します。
  • 引数：
    • filepath - PowerPoint プレゼンテーションへのパス。
    • slideIndex - スライドのインデックス（0 始まり）。
    • text - 追加するテキスト。
• ツール：PowerPoint のスライドタイトルを読み取る：PowerPoint プレゼンテーションのすべてのスライドからタイトルを読み取ります。
  • 引数：filepath - PowerPoint プレゼンテーションへのパス。
• ツール：PowerPoint のスライド数を取得：PowerPoint プレゼンテーションのスライド数を取得します。
  • 引数：filepath - PowerPoint プレゼンテーションへのパス。

デバッグと単独実行の方法

Office MCP Server を実行するには、次の手順に従ってください。

1. アプリケーションをビルドする： Maven がインストールされていることを確認してください。次のコマンドを実行してプロジェクトをビルドします。

   $ ./mvnw clean package
   

2. アプリケーションを実行する： ビルド後、次のコマンドを実行してサーバーを起動します。

   $ java -jar target/office-mcp-server-0.0.1-SNAPSHOT-runner.jar
   

3. アプリケーションにアクセスする： サーバーはデフォルトのポート 8080 で起動します。次の URL から API にアクセスできます。

   http://localhost:8080
   

4. 開発モードで実行する： 開発時には、Quarkus の開発モードを使用できます。

   $ ./mvnw quarkus:dev
   

設定

アプリケーションは、src/main/resources ディレクトリにある application.properties ファイルを使用して設定できます。主な設定オプションは次のとおりです。

• quarkus.mcp.server.sse.root-path：SSE のルートパスを設定します。

テスト

テストを実行するには、次のコマンドを使用します。

$ ./mvnw test

MCP サーバーのインストール

VS Code での MCP サーバーの設定

VS Code で設定する手順は次のとおりです。

• GitHub Copilot をインストールします
• コマンドパレットからこの MCP サーバーをインストールします：MCP: Add Server...
• チャットウィンドウ下部の矢印をクリックして、GitHub Copilot を Agent モードで実行するように設定します
• チャットウィンドウ上部に、ツールとして設定された office-mcp-server サーバーが表示されます

Claude Desktop での MCP サーバーの設定

Claude Desktop を使うと、MCP サーバーを簡単に設定してチャットできます。より高度な使い方をする場合は、VS Code の使用をおすすめします（次のセクションを参照してください）。

サーバーを claude_desktop_config.json ファイルに追加する必要があります。ダウンロードした office-mcp-server-0.0.1-SNAPSHOT-runner.jar ファイルの場所を指定してください。

{
    "mcpServers": {
        "office-mcp-server": {
            "command": "java",
            "args": [
                "-jar",
              "~/Downloads/office-mcp-server-0.0.1-SNAPSHOT-runner.jar"
            ]
        }
    }
}

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

サポート

このプロジェクトは現状のまま提供され、いかなる保証もありません。問題が発生した場合や質問がある場合は、GitHub リポジトリでイシューを作成してください。