Alfresco MCP Proof of Concept (PoC)

This repository contains a Proof of Concept (PoC) for integrating Alfresco as a Model Context Protocol server. The project demonstrates how to connect Alfresco capabilities to AI using standard client-server applications.

General Diagram

Project Structure

The repository is structured as follows:

alfresco/: Contains a Docker Compose setup for a standard Alfresco deployment. This must be run before the MCP integration.
alfresco-mcp-client/: A Java-based client application for interacting with the MCP server using Spring AI
alfresco-mcp-server/: A Node.js-based server application for handling MCP requests using TypeScript SDK

Prerequisites

Before running the project, ensure you have the following installed:

Docker (version 20.10.0 or higher)
Docker Compose (version 1.29.0 or higher)
Java Development Kit (JDK) 17 or higher (for the client application)
Node.js (version 18 or higher) and npm (for the server application)
Git (for cloning the repository)

Getting Started

Step 1: Clone the Repository

Clone the repository to your local machine:

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

Step 2: Run the Alfresco Docker Compose

Navigate to the alfresco/ directory and start the Alfresco deployment using Docker Compose:

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

This will start the Alfresco Content Services stack, including the repository, Share, and other required services. Wait for all services to initialize completely.

Step 3: Verify Alfresco Deployment

Once the services are up, you can access the Alfresco Share interface at:

Alfresco Share: http://localhost:8080/share
Alfresco Repository: http://localhost:8080/alfresco

Use the default credentials (admin / admin) to log in.

Step 4: Set Up and Run the MCP Client

Start the Ollama server locally:

ollama serve

Navigate to the alfresco-mcp-client/ directory and follow the instructions in its README.md to set up and run the MCP client:

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

Customization

You can customize the Alfresco deployment by modifying the docker-compose.yml file in the alfresco/ directory. Additionally, the MCP server and client components can be configured to suit your specific use case.

Contributing

Contributions to this project are welcome! Please open an issue or submit a pull request with your proposed changes.

MCP Servers