Alfresco Content Services

An integration verification project of Alfresco and the MCP protocol, demonstrating how to connect Alfresco capabilities to an AI system through a standard client - server application.

Knowledge management and memory Developer tools #Content Management #AI Integration #Protocol Verification .Java

rating : 2.5 points

downloads : 14

update time : 2025-04-28

What is the Alfresco MCP Server?

The Alfresco MCP server is an open - source tool based on the Model Context Protocol (MCP) that integrates Alfresco's enterprise content management capabilities with AI applications. Through this server, you can easily pass files, metadata, and other content to AI models for analysis and processing.

How to Use the Alfresco MCP Server?

To use the Alfresco MCP server, you need to start the Alfresco Content Service first and then run the MCP client to interact with the server. Finally, you can access the content in Alfresco through AI tools.

Applicable Scenarios

It is suitable for enterprise scenarios that require the combination of enterprise content management and AI analysis, such as intelligent document classification, automated content processing, and knowledge base construction.

Main Features

Support for the Standard MCP ProtocolFully compliant with the Model Context Protocol standard to ensure seamless integration with various AI frameworks.

Integration with Alfresco Content ServiceDirectly leverage Alfresco's powerful content management capabilities, including file storage, metadata analysis, and permission control.

Multilingual SupportSupport content processing in multiple languages to meet the needs of global enterprises.

Advantages and Limitations

Advantages

Simplify the integration process of AI and enterprise content management

Combine powerful content management capabilities with AI analysis

Open - source and free to use

Limitations

Requires a certain technical background for deployment and maintenance

Has certain requirements for the network environment

How to Use

Start the Alfresco Content Service

Run the Docker Compose command locally to start the Alfresco service.

Set Up the MCP Server

After installing Node.js and npm, clone the project and run the installation command in the server directory.

Run the MCP Client

Use Java to run the client program and communicate with the server.

Usage Examples

Intelligent Document ClassificationPass enterprise documents to an AI model for automatic classification based on content.

Content Summary GenerationExtract key information from long - form documents and generate summaries.

Frequently Asked Questions

How to verify that the Alfresco service is running properly?

Does the MCP server support custom models?

Are there any usage restrictions for the MCP server?

Related Resources

Alfresco Official Documentation

A detailed guide to Alfresco Content Service.

MCP Protocol Official Website

Understand how the MCP protocol works.

GitHub Project Address

Get the source code and more examples.

🚀 Alfresco MCP Proof of Concept (PoC)

This repository contains a Proof of Concept (PoC) that integrates Alfresco as a Model Context Protocol server. This project demonstrates how to combine Alfresco's capabilities with AI using a standard client-server application.

Overall Diagram

✨ Features

Integrate Alfresco with the Model Context Protocol.
Combine Alfresco's capabilities with AI.
Use standard client - server applications for interaction.

📦 Installation

Prerequisites

Before running the project, make sure you have installed the following:

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)

🚀 Quick Start

Step 1: Clone the Repository

Clone the repository on your local machine:

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

Step 2: Run 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 service stack, including the repository, Share, and other required services. Wait for all services to be fully initialized.

Step 3: Verify the Alfresco Deployment

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

Alfresco Share: http://localhost:8080/share
Alfresco Repository: http://localhost:8080/alfresco Log in using the default credentials (admin / admin).

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 the 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

📚 Documentation

Project Structure

The repository structure is as follows:

alfresco/: Contains a Docker Compose setup for a standard Alfresco deployment. This environment must be started before running 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 the TypeScript SDK.

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.