🚀 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 服务器和客户端组件可以配置为适合您的特定用例。

🤝 贡献

欢迎对此项目进行贡献！请打开问题或提交拉取请求以提出您的更改建议。