ArchiScribe MCP Server

The ArchiScribe MCP Server is a Model Context Protocol (MCP) server designed to retrieve architectural information from an ArchiMate model. It enables AI coding assistants and agents to access architectural context information during the software development lifecycle (SDLC). The information is returned in markdown, JSON, or YAML format, which are easily understood by LLMs.

More details here: https://declanbright.com/software/archiscribe-mcp-server/

Note: When deployed to Azure App Service, the server enforces Entra ID (Microsoft Entra) bearer token authentication. See the Authentication section for details. For local development, authentication is disabled automatically — no configuration required.

Note: The model file must be in the ArchiMate Exchange File (.xml) format.

---

Example

Here is a simple example from the demo model (/data/archimate-scribe-demo-model.xml).

This view depicts the ArchiScribe MCP Server reading a model file and Serving an AI Coding Agent, via it’s MCP interface.

• ArchiScribe MCP Server raw output
• AI generated documentation from the output

---

Installation

Install dependencies:

npm install

---

Running the Server

Production Mode

Compile and run the server:

npm run build
npm start

Development Mode

Run with automatic restart on file changes:

npm run dev

Uses ts-node-dev to execute TypeScript directly and restart on changes.

---

Verifying the Server

On successful startup, you should see:

MCP: initialising server
MCP: registered tool: SearchViews
MCP: registered tool: GetViewDetails
MCP: registered tool: SearchElements
MCP: registered tool: GetElementDetails
Server listening on port 3030

---

Available Scripts

---

MCP Client Configuration

Supports MCP over HTTP at the /mcp endpoint for integration with MCP clients.

VS Code Configuration

"archiscribe": {
  "url": "http://localhost:3030/mcp",
  "type": "http"
}

---

Authentication