Docspace MCP

🚀 ONLYOFFICE DocSpace MCP 服務器

[模型上下文協議]（MCP）是一種用於管理大語言模型（LLMs）與外部系統之間上下文的標準化協議。本倉庫為 ONLYOFFICE DocSpace 提供了一個 MCP 服務器。

DocSpace MCP 服務器可將 AI 工具直接連接到 ONLYOFFICE DocSpace。這使得 AI 代理、助手和聊天機器人能夠通過自然語言交互來管理房間、協作處理文件、處理權限並自動化文檔工作流程。

✨ 主要特性

• 工具精細控制：可訪問按邏輯組織成工具集的工具，具備細粒度的啟用/禁用功能和元工具。
• 多傳輸協議支持：支持標準輸入輸出（stdio）、服務器發送事件（SSE）和可流式傳輸的 HTTP 傳輸協議。
• 多種認證方式：支持 API 密鑰、個人訪問令牌、基本認證以及帶有動態客戶端註冊的 OAuth 2.0。詳見示例。
• 請求級配置：在會話初始化期間，可使用自定義 HTTP 頭配置認證和工具選擇。
• 多種分發格式：以Docker 鏡像、Docker MCP 服務器、MCP 捆綁包和 Node.js 應用程序的形式提供。

💻 使用示例

基礎用法

以下是該服務器在不同場景下的使用示例：

場景一：房間管理

Create a new project room and invite Anna with editor rights.

場景二：文件操作

Upload this file to "My documents".

高級用法

可根據不同的配置和需求，靈活運用服務器的各種特性。例如，使用不同的認證方式和傳輸協議，以及對工具進行精細控制等。

📦 安裝指南

連接客戶端到 DocSpace MCP 服務器

您可以使用任何 MCP 客戶端連接到 DocSpace MCP 服務器。我們已經涵蓋了一些流行的客戶端，如 Claude Desktop、Cursor、Windsurf 等，您可以點擊此處瞭解相關信息。

遠程 DocSpace MCP 服務器

遠程 DocSpace MCP 服務器由 ONLYOFFICE 託管，為您在 AI 代理中使用 DocSpace 工具提供了最快的方式。您無需在本地部署或配置任何內容，即可立即連接。

支持現代可流式傳輸 HTTP 傳輸的客戶端可訪問公共實例：https://mcp.onlyoffice.com/mcp；僅支持舊版 SSE 傳輸的客戶端可訪問：https://mcp.onlyoffice.com/sse。建議儘可能使用可流式傳輸的 HTTP 傳輸。

點擊此處查看將客戶端連接到遠程 DocSpace MCP 服務器的所有選項。

本地 DocSpace MCP 服務器

如果您的 MCP 主機不支持遠程 MCP 服務器，您可以運行 本地版本 的 DocSpace MCP 服務器。

大多數實現 MCP 協議的客戶端都有一個 JSON 格式的通用配置文件，您可以在其中添加 ONLYOFFICE DocSpace MCP 本地服務器。

注意：以下通用示例適用於 Docker 鏡像，因此您的系統必須安裝 Docker。

1. 定位配置文件：找到您客戶端的 .json 配置文件。
2. 添加 DocSpace MCP 服務器條目：將以下代碼塊插入到您 .json 配置文件的 mcpServers 部分：

{
    "mcpServers": {
        "onlyoffice-docspace": {
            "command": "docker",
            "args": ["run", "--interactive", "--rm", "--env", "DOCSPACE_BASE_URL", "--env", "DOCSPACE_API_KEY", "onlyoffice/docspace-mcp"],
            "env": {
                "DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
                "DOCSPACE_API_KEY": "your-api-key"
            }
        }
    }
}

3. 設置環境變量：
   • DOCSPACE_BASE_URL：您的 DocSpace 實例的 URL（例如：https://portal.onlyoffice.com）。
   • DOCSPACE_API_KEY：您在 DocSpace 設置 -> 開發者工具 -> API 密鑰中生成的個人 API 密鑰。 所有可用參數請點擊此處查看。
4. 重啟客戶端：關閉並重新打開您的客戶端。在大多數情況下，DocSpace MCP 服務器將自動啟動，您可以發出自然語言命令，例如：
   • 創建一個新的項目房間，並邀請 Anna 作為編輯人員。
   • 將此文件上傳到“我的文檔”。

📚 詳細文檔

服務器實現了 [MCP 規範] 中描述的工具概念。所有 DocSpace MCP 服務器工具的詳細信息請點擊此處查看。

完整的文檔請參考 docs 目錄。

📄 許可證

DocSpace MCP 服務器根據 LICENSE 文件中的 Apache 2.0 許可證進行分發。