README
🚀 Alfresco MCP 证明概念(PoC)
本项目是一个集成Alfresco作为Model Context Protocol服务器的概念验证(PoC)。它展示了如何将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作为Model Context Protocol服务器,展示了将Alfresco功能与AI结合的能力,通过标准的客户端 - 服务器应用程序实现特定功能。
📦 安装指南
按照快速开始中的步骤,依次完成克隆仓库、运行Alfresco Docker Compose、验证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服务器和客户端组件可以配置为适合您的特定用例。
🤝 贡献
欢迎对此项目进行贡献!请打开问题或提交拉取请求以提出您的更改建议。
微信扫一扫