Exeris AI Bridge MCP server
io.github.exeris-systems/ai-bridge·v0.8.0Read-only Exeris context for AI agents: ADRs, SDK contract, build output, kernel diagnostics.
0 stars45 downloads/wk
Reviews
Write oneNobody has reviewed Exeris AI Bridge yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Exeris AI Bridge tools (22)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bridge-healthReport which tool families can serve requests and why the others cannot.
bridge-versionIdentify this MCP server: package name and version, the Node runtime it
build-explain_artefactsList the files Exeris codegen has generated into this project, each with the generator that produced it and when that generator emits — handlers, services, repositories, domain errors, event publishers, graph projections, sagas, Flyway migrations, OpenAPI specs, and the project-wide bootstrap. Ask this BEFORE hand-writing SQL, a DTO or a controller for an Exeris entity: the build usually already e
build-explain_diagnosticDecode an error, warning or note exeris-tooling printed — an annotation-processor message, a codegen plugin goal failure or warning, a capability-graph or cap-tier Wall refusal, a missing runtime driver, a code-generation pipeline or CodegenMain line, or an exeris-initializr error. Paste the diagnostic text verbatim; returns what it means, the rule behind it, and what to do. Looks each diagnostic
build-get_detach_stateReport whether this project's generated code is still pipeline-owned (L1, src/main/generated/java — regenerated on every build, so edits are lost) or has been detached into the developer's own sources (L2, src/main/java — owned, safe to edit). Ask this before editing anything under a generated tree. Returns the state, the observations behind it, and how many files the pipeline claims.
build-get_domain_metadataFetch the DomainMetadata JSON the annotation processor emitted for one declaration of this project — the authoritative AST the code generators consume, including fields, actions, events, relationships and the system-field flags. `name` is the Java simple name (e.g. 'Station'), as listed by build-list_domains. Returns the record verbatim, plus the schemaVersion and (when the build could compute one
build-list_domainsList what this project's last build emitted into target/classes/exeris-metadata: every @ExerisDomain entity, plus the enums, capabilities and views the processor wrote alongside them, each with its kind. Use it to discover names before calling build-get_domain_metadata. A project that has not been built, or has no @ExerisDomain sources, returns present:false rather than an error.
caps-describe_compositionReport the composition stamp from cap-manifest.json: whether the capability graph validated, the composition version, and the content binding digest, alongside the manifest schema version, the module count and initOrder. Answers 'is this build's composition trustworthy, and which build is it'. A project with no capabilities returns a present:false answer, not an error.
caps-list_capabilitiesList the capability modules composed into this project, from the build-time cap-manifest.json: each module's qualified name, the services it provides with their versions, and which module owns the lifecycle. Also returns initOrder exactly as the manifest states it. A project with no capabilities returns an empty list, not an error.
kernel-describe_subsystemDetail for a single kernel subsystem by name (e.g. memory, crypto, persistence, graph, transport, events, flow, http, security).
kernel-get_bootstrap_dagSnapshot of the kernel bootstrap dependency DAG — nodes (subsystems) with their phase, declared dependencies, and running state.
kernel-get_jvm_ergonomicsWhat the JVM running the kernel actually resolved at startup: selected GC, max/committed heap, visible processors, and the container limits it detected (cgroup CPU quota/period, memory cap, cpuset) plus large-page, CDS and AOT-cache state. Null fields mean the kernel could not determine that value. A kernel that does not implement this answers a snapshot with gcName 'unknown' and -1 byte counts.
kernel-list_providersList all SPI providers registered with the running kernel, including driver origin (community/enterprise priority).
lsp-describe_domainReturn the source-model description of an @ExerisDomain type: fields, actions, relationships, generated artefacts, and the `sourceDigest` that `lsp-preview_mutation` takes as its concurrency token.
lsp-list_actionsList all @Action methods across the workspace, with their owning @ExerisDomain.
lsp-list_domainsList all @ExerisDomain types known to the active LSP session.
lsp-preview_mutationPreview how the SDK's canonical writer would change an @ExerisDomain source file for one mutation, applied in memory. Returns `{ result, sourcePath, diff }`: a unified diff and the SDK outcome in `result.outcome` — SUCCESS, CONFLICT (the source drifted from the baseline; the result carries baseline, current and intended values), VALIDATION_ERROR, or NO_BASELINE. Nothing is written: apply the diff
sdk-describe_annotationDescribe a specific Exeris SDK annotation: simple and qualified name, owning package rationale, targets, retention, purpose, detailed description, all attributes (with types, defaults, required-ness, descriptions, and deprecations), and annotation-level deprecation status.
sdk-get_ast_schemaGet JSON Schema for the Exeris build-time DomainMetadata AST and sibling records. If 'definition' is omitted, returns the top-level schema envelope, reader requirements (such as Jackson 3 constraints), and definition list. If 'definition' is specified (e.g. 'DomainMetadata', 'FieldMetadata', 'ActionMetadata'), returns the schema definition for that specific record.
sdk-get_scoping_rulesGet canonical authoring contract scoping rules for Exeris SDK annotations (including @Field vs @Validation split, FieldMetadata as single AST carrier per ADR-054, derived SQL NOT NULL and API not-blank generator semantics, form lifecycle scoping, deprecations, and sibling vs nested form trap). Supports optional filtering by rule ID or query string.
sdk-list_annotationsList Exeris SDK annotations from the authoring contract: name, qualified name, package, targets, retention, and purpose. Supports optional filtering by package (e.g. 'system', 'security', 'capability', or full package name), target (e.g. 'METHOD', 'TYPE', 'FIELD'), or query string.
sdk-list_deprecationsList all deprecated Exeris SDK annotations and attributes across the authoring contract, including replacement guidance, since version, and forRemoval status. Supports filtering by package or forRemoval only.
Public scan report
scanner v0.1.10 · 2026-10-25 · same rubric, same numbers if you re-run it
- Code scan71 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Exeris AI Bridge compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 91/100
- higher than 85% of 48,255 servers
- Tools
- 22
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 45
- more than 37% of 12,191 servers with a package
What its tools let an agent do: 22 read
Install Exeris AI Bridge in Claude Code, Cursor or VS Code
Runs npx -y @exeris/ai-bridge on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ai-bridge -- npx -y @exeris/ai-bridge
What the publisher says
From the Exeris AI Bridge repository's README, as published. We do not edit it. Read it on GitHub
@exeris/ai-bridge
Model Context Protocol server that gives AI agents the context of an Exeris application: what
your build emitted, the SDK's authoring contract, the ADR registry, and a running kernel.
Every tool is a read. The bridge never writes to your project, never calls a model API, and runs as a separate process from the Java kernel. It is built for developers writing an application on Exeris, and works without a checkout of the ecosystem: the reference data it needs ships inside the package.
Installation
Run the server inside your project, so it finds your pom.xml.
Claude Code
claude mcp add exeris -- npx -y @exeris/ai-bridgeClaude Desktop: install exeris-ai-bridge-.mcpb from the GitHub Releases. Desktop does not start the server inside a project, so set Project root in the extension's settings to use the build- and caps- tools.
Any other MCP client (Cursor, VS Code, Copilot): the command is npx -y @exeris/ai-bridge over stdio.
{
"mcpServers": {
"exeris": { "command": "npx", "args": ["-y", "@exeris/ai-bridge"] }
}
}The server is also listed in the MCP Registry as io.github.exeris-systems/ai-bridge.
Requirements
Maven repository, which a build of an Exeris application puts there.
- Node 20 or newer.
- kernel-* only: JDK 25 or newer, and eu.exeris:exeris-kernel-diagnostics-cli in your local
- No network at run time. The bridge reads artefacts already in ~/.m2 and never downloads.
Tools
Tool names are family-tool. All 31 are listed in every session; a family whose dependency is missing answers with a structured family_unavailable result naming the reason and the remedy.
docs-listrepos, docs-listrepodocs and docs-getrepodoc need a checkout of the Exeris repositories; the other docs- tools answer from a registry snapshot bundled in the package. lsp-* needs a locally built exeris-platform-lsp, which publishes no runnable jar yet.
Configuration
Nothing needs setting for an application. Every variable is optional, and none can stop the server from booting.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Exeris AI Bridge: common questions
- Is Exeris AI Bridge MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Exeris AI Bridge safety report
- How do I install Exeris AI Bridge?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Exeris AI Bridge need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Exeris AI Bridge maintained?
- The last commit was 14 days ago (2026-10-21). The latest release is v0.8.0.
- What can I use instead of Exeris AI Bridge?
- Servers from other publishers that do the same job: Ouroboros MCP server.
- How does Exeris AI Bridge compare with other MCP servers?
- safety score 91/100 (higher than 85% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Exeris AI Bridge
Same job from other publishers: the closest match first, then the best rated.
- OuroborosPins an acceptance spec; the verify command and expected output never enter the success contract.not reviewedWidely usedC