Alfresco Content Services

🚀 Alfresco MCP 證明概念（PoC）

本項目是一個概念驗證（PoC），展示瞭如何將 Alfresco 集成到 Model Context Protocol 服務器 中。它將 Alfresco 的功能與人工智能相結合，通過標準的客戶端 - 服務器應用程序實現，為相關領域的應用提供了新的思路和實踐參考。

🚀 快速開始

先決條件

在運行項目之前，請確保安裝了以下內容：

• Docker（版本 20.10.0 或更高）
• Docker Compose（版本 1.29.0 或更高）
• Java Development Kit (JDK) 17 或更高版本（用於客戶端應用程序）
• Node.js（版本 18 或更高）和 npm（用於服務器應用程序）
• Git（用於克隆倉庫）

步驟 1：克隆倉庫

在本地機器上克隆倉庫：

git clone https://github.com/aborroy/alfresco-mcp-poc.git
cd alfresco-mcp-poc

步驟 2：運行 Alfresco Docker Compose

導航到 alfresco/ 目錄並使用 Docker Compose 啟動 Alfresco 部署：

cd alfresco
docker-compose up --build --force-recreate

這將啟動 Alfresco 內容服務堆棧，包括存儲庫、Share 和其他所需服務。請耐心等待所有服務完全初始化。

步驟 3：驗證 Alfresco 部署

一旦服務啟動，您可以在以下位置訪問 Alfresco Share 界面：

• Alfresco Share：http://localhost:8080/share
• Alfresco 存儲庫：http://localhost:8080/alfresco 使用默認憑據（admin / admin）登錄。

步驟 4：設置並運行 MCP 客戶端

本地啟動 Ollama 服務器：

ollama serve

導航到 alfresco-mcp-client/ 目錄，並按照其中 README.md 的說明進行設置和運行 MCP 客戶端：

cd ../alfresco-mcp-client
mvn clean package
java -jar target/alfresco-mcp-client-0.8.0.jar

✨ 主要特性

此項目將 Alfresco 與 AI 結合，藉助標準的客戶端 - 服務器應用程序，實現了 Alfresco 功能在特定場景下的拓展，為相關業務提供了更智能的解決方案。

📦 安裝指南

按照上述快速開始部分的步驟，依次完成倉庫克隆、Alfresco 部署啟動、服務驗證以及 MCP 客戶端的設置和運行，即可完成項目的安裝與啟動。

📚 詳細文檔

項目結構

倉庫結構如下：

• alfresco/：包含一個 Docker Compose 設置，用於標準的 Alfresco 部署。必須在運行 MCP 集成之前啟動此環境。
• alfresco-mcp-client/：一個基於 Java 的客戶端應用程序，用於使用 Spring AI 與 MCP 服務器交互。
• alfresco-mcp-server/：一個基於 Node.js 的服務器應用程序，用於處理 MCP 請求，使用 TypeScript SDK。

自定義

您可以通過修改 alfresco/ 目錄中的 docker-compose.yml 文件來自定義 Alfresco 部署。此外，MCP 服務器和客戶端組件可以配置為適合您的特定用例。

🤝 貢獻

歡迎對此項目進行貢獻！請打開問題或提交拉取請求以提出您的更改建議。