Alfresco MCP 概念验证（PoC）

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

项目结构

仓库结构如下：

• alfresco/：包含用于标准Alfresco部署的Docker Compose设置。在进行MCP集成之前必须运行此设置。
• alfresco-mcp-client/：基于Java的客户端应用程序，用于通过Spring AI与MCP服务器交互。
• alfresco-mcp-server/：基于Node.js的服务器应用程序，用于通过TypeScript SDK处理MCP请求。

预备条件

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

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

开始使用

第一步：克隆仓库

将仓库克隆到本地机器：

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内容服务堆栈，包括存储库、Share和其他所需服务。等待所有服务完全初始化。

第三步：验证Alfresco部署

一旦服务启动，您可以通过以下地址访问Alfresco Share界面：

• Alfresco Share：http://localhost:8080/share
• Alfresco 存储库：http://localhost:8080/alfresco

使用默认凭据（admin / admin）登录。

第四步：设置并运行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服务器和客户端组件也可以配置以适应您的特定用例。

贡献

欢迎对此项目做出贡献！请打开一个问题或提交一个包含您建议更改的拉取请求。