Home / MCP / Alfresco MCP Server

Alfresco MCP Server

Provides a REST API to interact with Alfresco repositories via the Model Context Protocol Server for reading metadata, downloading content, and searching nodes.

typescript
Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
    "mcpServers": {
        "alfresco_mcp": {
            "command": "node",
            "args": [
                "alfresco-rest-server.js"
            ],
            "env": {
                "ALFRESCO_HOST": "YOUR_ALFRESCO_HOST",
                "ALFRESCO_USERNAME": "YOUR_USERNAME",
                "ALFRESCO_PASSWORD": "YOUR_PASSWORD"
            }
        }
    }
}

You use the Alfresco MCP Server to interact with Alfresco repositories through the Model Context Protocol Server. It lets you read node metadata, download node content, and perform advanced searches, all via a lightweight MCP interface that can be driven by any MCP client.

How to use

You connect with an MCP client to perform three core actions: read metadata for a node, download the content of a node, and search for files within your Alfresco repository. You can also discover and run tools like search and readContent to extend what you can do from your client. Use the available endpoints and tools to build automations, integrate Alfresco data into workflows, and quickly retrieve exact information you need.

How to install

Prerequisites you need before running the server are Node.js version 16 or higher and an Alfresco instance with REST API access. Ensure you can reach the Alfresco repository from the server host.

Install the necessary dependencies, then start the server. Run these commands from your project directory.

npm install dotenv @modelcontextprotocol/sdk
node alfresco-rest-server.js

Available tools

readNodeMetadata

Read metadata for a specific Alfresco node by its ID or URI.

downloadNodeContent

Download the content/file associated with a specific Alfresco node.

searchNodes

Perform a full-text search to locate files or nodes within Alfresco.

readContent

Read the content of a file by its Alfresco URI using the MCP tool interface.