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.

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.