Alfresco MCP Poc

Alfresco MCP概念验证（PoC）

该存储库包含一个概念验证（PoC），用于将Alfresco集成为 模型上下文协议服务器该项目演示了如何使用标准客户端-服务器应用程序将Alfresco功能连接到AI。

General Diagram

项目结构

存储库的结构如下：

• alfresco/：包含用于标准Alfresco部署的Docker Compose设置。这必须在MCP集成之前运行。
• alfresco-mcp-client/：一个基于Java的客户端应用程序，用于使用以下命令与MCP服务器交互 春季AI
• alfresco-mcp-server/：一个基于Node.js的服务器应用程序，用于处理MCP请求，使用 TypeScript SDK

先决条件

在运行项目之前，请确保已安装以下内容：

• Docker（20.10.0或更高版本）
• Docker Compose（1.29.0或更高版本）
• Java开发工具包（JDK）17或更高版本（用于客户端应用程序）
• Node.js（版本18或更高）和npm（用于服务器应用程序）
• Git（用于克隆存储库）

入门指南

步骤1：克隆存储库

将存储库克隆到本地计算机：

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

第二步：运行Alfresco Docker Compose

导航到 alfresco/ 使用Docker Compose启动Alfresco部署：

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

这将启动Alfresco内容服务堆栈，包括存储库、共享和其他所需服务。等待所有服务完全初始化。

步骤3：验证Alfresco部署

服务启动后，您可以访问Alfresco Share界面：

• Alfresco分享: 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部署来进行自定义 docker-compose.yml 文件在 alfresco/ 目录。此外，MCP服务器和客户端组件可以配置为适合您的特定用例。

贡献

欢迎为这个项目捐款！请打开一个问题或提交一个包含您提出的更改的拉取请求。