tridion-dxd
An example Model Context Protocol Server for Tridion DXD
claude mcp add --transport stdio rws-tridion-dxd-mcp-server java -jar target/mcp-server.jar \ --env DXD_TOKEN_URL="URL to Tridion DXD Token Service (required)" \ --env DXD_CONTENT_URL="URL to Tridion DXD Content Service (required)" \ --env DXD_CLIENT_SECRET="Client secret for Tridion DXD (required)"
How to use
This MCP server is an example implementation for Tridion DXD written in Java and built with Maven. It integrates with the Tridion DXD Content Service and Token Service to expose Model Context Protocol endpoints for querying and interacting with Tridion DXD data. Before running, ensure you have a running DXD Content Service and Token Service, and that the required environment variables are set so the server can authenticate and reach the services. You can build and run the server with Maven, and then connect MCP clients or the MCP Inspector to test model queries and tool interactions.
Once running, you can use the MCP Inspector (a debugging tool) to explore the server, validate model contexts, and inspect the available MCP endpoints and capabilities exposed by this Tridion DXD server. The inspector can be started with: npx @modelcontextprotocol/inspector. This helps verify the server is reachable, the authentication flow is working, and the MCP endpoints respond with the expected model data.
How to install
Prerequisites:
- Java 21 installed
- Maven (classic or wrapper) available on PATH
- Access to a running Tridion DXD Content Service and Token Service
Steps:
-
Clone the repository and navigate to the project directory.
-
Build the project using Maven:
mvn clean install -U
-
Ensure the following environment variables are set (example values shown; replace with real credentials/URLs):
DXD_CLIENT_SECRET=your-client-secret DXD_CONTENT_URL=https://your-dxd-content-service.example.com DXD_TOKEN_URL=https://your-dxd-token-service.example.com
-
Run the MCP server with Spring Boot (the project uses the Spring Boot Maven Plugin during the build):
mvn spring-boot:run
-
Verify the server starts and is reachable. You should see logs indicating the MCP server is listening for connections.
Additional notes
Environment variables are required for authenticating against the Tridion DXD services. Ensure the Content URL and Token URL are accessible from the host running the MCP server. If you encounter connection or authentication issues, check network access, TLS certificates, and that DXD_TOKEN_URL is the correct endpoint for token acquisition. Building the project requires Java 21 and Maven; use -U to force updates if dependencies are cached. The MCP Inspector can be used to quickly validate MCP endpoints; launch it with npx @modelcontextprotocol/inspector and point it at your running server.
