---
slug: "alfresco-content-services"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/aborroy/alfresco-mcp-poc@main/README.md"
repo: "https://github.com/aborroy/alfresco-mcp-poc"
source_file: "README.md"
branch: "main"
---
# Alfresco MCP Proof of Concept (PoC)

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

![General Diagram](https://github.com/aborroy/alfresco-mcp-poc/raw/HEAD/docs/diagram.png)

## 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](https://spring.io/projects/spring-ai)
- **`alfresco-mcp-server/`**: A Node.js-based server application for handling MCP requests using [TypeScript SDK](https://github.com/modelcontextprotocol/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:

```bash
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:

```bash
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](http://localhost:8080/share)
- **Alfresco Repository**: [http://localhost:8080/alfresco](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:

```bash
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:

```bash
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.