archimate-mcp 0.4.0__tar.gz

archimate_mcp-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Knuckles-Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

archimate_mcp-0.4.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include requirements.txt
+recursive-include archimate_mcp *.py
+recursive-include archimate_mcp *.json
+recursive-include archimate_mcp/agent_data *

archimate_mcp-0.4.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: archimate-mcp
+Version: 0.4.0
+Summary: ArchiMate model engine + MCP Server + A2A Server for Agentic AI!
+Author-email: Audel Rouhi <knucklessg1@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agent-utilities>=0.41.0
+Provides-Extra: mcp
+Requires-Dist: agent-utilities[mcp]>=0.41.0; extra == "mcp"
+Provides-Extra: agent
+Requires-Dist: agent-utilities[agent,logfire]>=0.41.0; extra == "agent"
+Provides-Extra: all
+Requires-Dist: agent-utilities[agent,logfire,mcp]>=0.41.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: license-file
+
+# archimate-mcp
+
+A self-contained **ArchiMate model engine** exposed as a Model Context
+Protocol (MCP) server and an A2A agent. It gives AI agents full ArchiMate 3.x
+authoring capabilities — create/load/save models, full CRUD on elements,
+relationships, folders, and views (diagrams), query/traverse the model, and
+import/export the **Open Group Model Exchange File Format** so the models open
+directly in [Archi](https://www.archimatetool.com/).
+
+Archi has no native server API, so `archimate-mcp` ships its own dependency-light
+engine built on the Python standard library (`xml.etree.ElementTree`).
+
+## Table of Contents
+- [Overview](#overview)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Architecture](#architecture)
+- [Deployment](#deployment)
+- [Environment Variables](#environment-variables)
+- [MCP Tools](#mcp-tools)
+
+## Overview
+`archimate-mcp` exposes a standardized interface for authoring ArchiMate models via
+the Model Context Protocol. The full ArchiMate vocabulary (Strategy, Business,
+Application, Technology, Physical, Motivation, Implementation layers) and all
+relationship types are supported, with structural validation and round-trip
+Open Exchange Format serialization.
+
+## Installation
+```bash
+pip install -e .
+```
+
+## Usage
+Run the MCP server directly:
+```bash
+archimate-mcp
+```
+
+Or run the agent server:
+```bash
+archimate-agent
+```
+
+## Architecture
+See `/docs` for architectural diagrams and further documentation. The model
+engine lives in `archimate_mcp/api/` (`archimate_model.py`, `api_client_archi.py`),
+the MCP tools in `archimate_mcp/mcp/mcp_archi.py`.
+
+## Deployment
+### Bare-metal
+```bash
+archimate-agent
+```
+
+### Docker
+```bash
+docker build -f docker/Dockerfile -t archimate-mcp .
+```
+
+## Environment Variables
+| Variable | Description |
+|----------|-------------|
+| `ARCHI_MODEL_PATH` | Path to the working model file (Open Exchange Format). Default `./model.archimate`. |
+| `ARCHITOOL` | Enable/disable the ArchiMate tool registration. Default `True`. |
+
+## MCP Tools
+| Tool | Description |
+|------|-------------|
+| `archi_model` | Model lifecycle: new/load/save/export_exchange/import_exchange/summary |
+| `archi_element` | Element CRUD: add/get/update/delete/list/find |
+| `archi_relationship` | Relationship CRUD + validate: add/get/update/delete/list/validate |
+| `archi_view` | Views (diagrams): create/add_element/add_connection/list/get |
+| `archi_folder` | Organizations (folders): add/move/list |
+| `archi_query` | Query/traversal: neighbors/relationships_of/by_type + vocabulary |

archimate_mcp-0.4.0/README.md

@@ -0,0 +1,75 @@
+# archimate-mcp
+
+A self-contained **ArchiMate model engine** exposed as a Model Context
+Protocol (MCP) server and an A2A agent. It gives AI agents full ArchiMate 3.x
+authoring capabilities — create/load/save models, full CRUD on elements,
+relationships, folders, and views (diagrams), query/traverse the model, and
+import/export the **Open Group Model Exchange File Format** so the models open
+directly in [Archi](https://www.archimatetool.com/).
+
+Archi has no native server API, so `archimate-mcp` ships its own dependency-light
+engine built on the Python standard library (`xml.etree.ElementTree`).
+
+## Table of Contents
+- [Overview](#overview)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Architecture](#architecture)
+- [Deployment](#deployment)
+- [Environment Variables](#environment-variables)
+- [MCP Tools](#mcp-tools)
+
+## Overview
+`archimate-mcp` exposes a standardized interface for authoring ArchiMate models via
+the Model Context Protocol. The full ArchiMate vocabulary (Strategy, Business,
+Application, Technology, Physical, Motivation, Implementation layers) and all
+relationship types are supported, with structural validation and round-trip
+Open Exchange Format serialization.
+
+## Installation
+```bash
+pip install -e .
+```
+
+## Usage
+Run the MCP server directly:
+```bash
+archimate-mcp
+```
+
+Or run the agent server:
+```bash
+archimate-agent
+```
+
+## Architecture
+See `/docs` for architectural diagrams and further documentation. The model
+engine lives in `archimate_mcp/api/` (`archimate_model.py`, `api_client_archi.py`),
+the MCP tools in `archimate_mcp/mcp/mcp_archi.py`.
+
+## Deployment
+### Bare-metal
+```bash
+archimate-agent
+```
+
+### Docker
+```bash
+docker build -f docker/Dockerfile -t archimate-mcp .
+```
+
+## Environment Variables
+| Variable | Description |
+|----------|-------------|
+| `ARCHI_MODEL_PATH` | Path to the working model file (Open Exchange Format). Default `./model.archimate`. |
+| `ARCHITOOL` | Enable/disable the ArchiMate tool registration. Default `True`. |
+
+## MCP Tools
+| Tool | Description |
+|------|-------------|
+| `archi_model` | Model lifecycle: new/load/save/export_exchange/import_exchange/summary |
+| `archi_element` | Element CRUD: add/get/update/delete/list/find |
+| `archi_relationship` | Relationship CRUD + validate: add/get/update/delete/list/validate |
+| `archi_view` | Views (diagrams): create/add_element/add_connection/list/get |
+| `archi_folder` | Organizations (folders): add/move/list |
+| `archi_query` | Query/traversal: neighbors/relationships_of/by_type + vocabulary |

archimate_mcp-0.4.0/archimate_mcp/__init__.py

@@ -0,0 +1,64 @@
+"""archimate-mcp: ArchiMate model engine + MCP Server + A2A Server."""
+
+import importlib
+import inspect
+from typing import Any
+
+__version__ = "0.2.0"
+__all__: list[str] = []
+
+CORE_MODULES = ["archimate_mcp.api_client"]
+OPTIONAL_MODULES = {
+    "archimate_mcp.agent_server": "agent",
+    "archimate_mcp.mcp_server": "mcp",
+}
+
+
+def _expose_members(module):
+    for name, obj in inspect.getmembers(module):
+        if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
+            "_"
+        ):
+            globals()[name] = obj
+            if name not in __all__:
+                __all__.append(name)
+
+
+for module_name in CORE_MODULES:
+    module = importlib.import_module(module_name)
+    _expose_members(module)
+
+_loaded_optional_modules = {}
+
+
+def _import_module_safely(module_name: str):
+    try:
+        return importlib.import_module(module_name)
+    except ImportError:
+        return None
+
+
+def __getattr__(name: str) -> Any:
+    if name == "_MCP_AVAILABLE":
+        mcp_key = next((k for k in OPTIONAL_MODULES if "mcp_server" in k), None)
+        return _import_module_safely(mcp_key) is not None if mcp_key else False
+    if name == "_AGENT_AVAILABLE":
+        agent_key = next((k for k in OPTIONAL_MODULES if "agent_server" in k), None)
+        return _import_module_safely(agent_key) is not None if agent_key else False
+
+    for module_name in OPTIONAL_MODULES:
+        if module_name not in _loaded_optional_modules:
+            module = _import_module_safely(module_name)
+            if module is not None:
+                _loaded_optional_modules[module_name] = module
+                _expose_members(module)
+
+        module = _loaded_optional_modules.get(module_name)
+        if module is not None and hasattr(module, name):
+            return getattr(module, name)
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted(list(globals().keys()) + __all__)

archimate_mcp-0.4.0/archimate_mcp/__main__.py

@@ -0,0 +1,4 @@
+from archimate_mcp.agent_server import agent_server
+
+if __name__ == "__main__":
+    agent_server()

archimate_mcp-0.4.0/archimate_mcp/agent_server.py

@@ -0,0 +1,73 @@
+"""Graph-based Pydantic AI agent server entry point for archimate-mcp."""
+
+import logging
+import os
+import sys
+import warnings
+
+__version__ = "0.2.0"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+)
+logger = logging.getLogger(__name__)
+
+DEFAULT_AGENT_NAME = None
+DEFAULT_AGENT_DESCRIPTION = None
+DEFAULT_AGENT_SYSTEM_PROMPT = None
+
+
+def agent_server():
+    """Start the graph-based Pydantic AI agent server for ArchiMate."""
+    from agent_utilities import (
+        build_system_prompt_from_workspace,
+        create_agent_parser,
+        create_agent_server,
+        initialize_workspace,
+        load_identity,
+    )
+
+    global DEFAULT_AGENT_NAME, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_SYSTEM_PROMPT
+    initialize_workspace()
+    meta = load_identity()
+    DEFAULT_AGENT_NAME = os.getenv(
+        "DEFAULT_AGENT_NAME", meta.get("name", "Archi Agent")
+    )
+    DEFAULT_AGENT_DESCRIPTION = os.getenv(
+        "AGENT_DESCRIPTION",
+        meta.get("description", "AI agent for ArchiMate modeling operations."),
+    )
+    DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
+        "AGENT_SYSTEM_PROMPT",
+        meta.get("content") or build_system_prompt_from_workspace(),
+    )
+
+    warnings.filterwarnings("ignore", message=".*urllib3.*")
+    warnings.filterwarnings("ignore", category=DeprecationWarning, module="fastmcp")
+
+    print(f"{DEFAULT_AGENT_NAME} v{__version__}", file=sys.stderr)
+    parser = create_agent_parser()
+    args = parser.parse_args()
+
+    create_agent_server(
+        mcp_url=args.mcp_url,
+        mcp_config=args.mcp_config or "mcp_config.json",
+        host=args.host,
+        port=args.port,
+        provider=args.provider,
+        model_id=args.model_id,
+        router_model=args.model_id,
+        agent_model=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        custom_skills_directory=args.custom_skills_directory,
+        enable_web_ui=args.web,
+        enable_otel=args.otel,
+        otel_endpoint=args.otel_endpoint,
+        otel_headers=args.otel_headers,
+        otel_public_key=args.otel_public_key,
+        otel_secret_key=args.otel_secret_key,
+        otel_protocol=args.otel_protocol,
+        debug=args.debug,
+    )