Office MCP Server

🚀 辦公室 MCP 服務器

Office MCP Server 是一個基於 Java 的非官方 模型上下文協議 (MCP) 服務器，主要用於管理和處理來自 AI 代理對 Word、Excel 等文件的請求，為辦公文件處理提供了高效的解決方案。

🚀 快速開始

下載項目

克隆或下載 Office MCP Server 項目的源代碼。

構建項目

使用 Maven 或 Gradle 等工具構建項目，生成可執行的 JAR 文件。

運行服務器

1. 打開終端，導航到項目目錄。
2. 運行以下命令啟動服務器：

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

訪問 API

打開瀏覽器或使用工具（如 Postman）訪問服務器提供的 API 端點。默認情況下，服務器運行在 http://localhost:8080。有關更多詳細信息，請參考 文檔。

✨ 主要特性

• 基於 Java 構建，使用 Quarkus 框架，具備快速啟動時間和低內存使用率，適合雲原生應用。
• 支持多種 MCP 工具和資源，可對 Excel 文件進行多種操作。

📦 安裝指南

通過 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

💻 使用示例

基礎用法

目前文檔未提供基礎使用的代碼示例，後續可根據實際情況補充。

📚 詳細文檔

框架

該項目使用 Quarkus 構建，這是一個專為構建輕量級、高性能微服務設計的 Kubernetes 原生 Java 框架。Quarkus 提供了快速啟動時間和低內存使用率，非常適合雲原生應用。

支持的方法

該服務器支持以下 MCP 工具和資源：

Excel 功能

配置

環境變量配置

您可以通過以下環境變量自定義服務器的行為：

日誌文件

默認情況下，日誌文件保存在 logs/ 目錄下。您可以根據需要修改日誌輸出路徑或格式。

測試

單元測試

使用 Maven 或 Gradle 運行單元測試：

./mvnw test

集成測試

在項目根目錄下運行集成測試腳本：

sh tests/run_integration_tests.sh

🔧 技術細節

該項目使用 Quarkus 框架構建，利用其輕量級、高性能的特性，實現了對 MCP 協議的支持，能夠高效管理和處理來自 AI 代理的辦公文件請求。同時，通過環境變量配置和日誌管理，提高了項目的靈活性和可維護性。

📄 許可證

該項目在 MIT 許可證下發布。有關詳細信息，請參閱 LICENSE 文件。

支持

該項目按現狀提供，不附帶任何保證。如果遇到問題或有疑問，請在 GitHub 倉庫中打開問題。