Office MCP Server

🚀 オフィス MCP サーバ

Office MCP Server は、Java をベースとした非公式の モデルコンテキストプロトコル (MCP) サーバ です。このサーバは、AI エージェントからの Word、Excel などのファイルのリクエストを管理および処理することを目的としています。

🚀 クイックスタート

このサーバを使用することで、AI エージェントからの Word、Excel などのファイルのリクエストを効率的に管理および処理することができます。以下に、サーバの起動方法や使用方法を説明します。

✨ 主な機能

フレームワーク

このプロジェクトは Quarkus を使用して構築されています。Quarkus は、軽量で高性能なマイクロサービスを構築するために設計された Kubernetes ネイティブの Java フレームワークです。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 機能について記載されていないため、ここでは空白となっています。）

📦 インストール

Maven を使用したインストール

pom.xml ファイルに以下の依存関係を追加します。

<dependency>
    <groupId>com.example</groupId>
    <artifactId>office-mcp-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

次に、Maven のインストールコマンドを実行します。

./mvnw clean install

Gradle を使用したインストール

build.gradle ファイルに以下の依存関係を追加します。

dependencies {
    implementation 'com.example:office-mcp-server:0.0.1-SNAPSHOT'
}

次に、Gradle のインストールコマンドを実行します。

./gradlew clean build

💻 使用例

サーバの起動

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

ユニットテストの実行

./mvnw test

統合テストの実行

sh tests/run_integration_tests.sh

📚 ドキュメント

設定

環境変数設定

以下の環境変数を使用して、サーバの動作をカスタマイズできます。

• PORT：サーバのリスニングポートを指定します。デフォルトは 8080 です。
• LOG_LEVEL：ログレベルを設定します。選択可能な値は DEBUG、INFO、WARN、ERROR で、デフォルトは INFO です。

ログファイル

デフォルトでは、ログファイルは logs/ ディレクトリに保存されます。必要に応じて、ログ出力パスや形式を変更できます。

テスト

• ユニットテスト：Maven または Gradle を使用してユニットテストを実行します。
• 統合テスト：プロジェクトのルートディレクトリで統合テストスクリプトを実行します。

🔧 技術詳細

このプロジェクトは、Quarkus フレームワークを使用して構築されています。Quarkus は、Kubernetes ネイティブの Java フレームワークで、高速な起動時間と低いメモリ使用率を提供します。これにより、クラウドネイティブアプリケーションに非常に適したサーバを構築することができます。

📄 ライセンス

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

サポート

このプロジェクトは現状のまま提供され、一切の保証を伴いません。問題が発生した場合や質問がある場合は、GitHub リポジトリに問題を登録してください。