Ada MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ada MCP Server show me the diagnostics for src/main.adb"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ada MCP Server
Ada MCP lets an MCP client inspect your Ada projects through Ada Language Server. Select your existing GPR project and use source-aware results to understand code without leaving your assistant workflow.
You can:
Explore a project's structure and symbols in its selected GPR view.
Navigate to definitions and inspect hover information at real source locations.
Request diagnostics for specific Ada files.
File diagnostics complement your project's compiler and tests. See the support matrix for the supported queries and current limits.
Install, connect and use
You need Git, Python 3.11+, Bash 3.2+ and Docker able to run Linux/AMD64 containers. Use a nonroot account with Docker access and readable project sources. You do not need to build Ada MCP or run this repository's CI.
Choose and acquire a published release and create a shared Docker binding for your projects and dependencies. The guide verifies published downloads before setup and retains a pinned RC1 fallback.
Use the bundled MCP query client, or prepare your client's stdio connection. Native client integration is experimental and needs checks in that client.
Select your actual GPR file, dependency search paths and scenarios. Ask questions such as “Which symbols does this file define?”, “Where is this symbol defined?” or “What diagnostics were published for this file?”. Compare returned locations and scope with your source.
This direct MCP workflow is independent of Plugin Creator and any private publisher account. Optional conveniences are local Codex skill discovery and your own private Cloud skill-plugin copy. The plugin supplies instructions; it does not register native MCP tools.
This is a pilot for the documented Linux/AMD64 Docker workflow. macOS, native Codex/Claude/OpenCode integration and importing the Cloud plugin into a separate account remain in development. See the first-install guide for host details and GitHub Releases for versions that are actually published.
RC2 adds release checks and approved updates: search for a new release and let the skill verify and execute an update after your approval. Existing RC1 installations need an initial approved upgrade to a published RC2 or later; their immutable packages have no update-notice hook. RC3 adds runtime reuse without replacing the skill/plugin. Use it only after publication; existing RC2 entries need one initial entry upgrade, and later sessions need the same retained files and selection path.
Related MCP server: VSC as MCP
Contributing
To change, build, test or release Ada MCP itself, read the contributor development guide.
This is the independently maintained abuild-project continuation of MDBrothers/ada-mcp-server. Original history, authorship and MIT notices are preserved. See LICENSE and component licensing.
Available Tools
19 toolsada_alire_infoB
Get Alire project information from alire.toml
Inputs: project_dir.
ada_buildC
Build an Ada project using GPRbuild and return compilation results
Inputs: clean, target, gpr_file, extra_args.
ada_call_hierarchyB
Get call hierarchy (incoming/outgoing calls) for an Ada symbol
Inputs: file (required), line (required), column (required), direction.
ada_code_actionsC
Get available code actions (quick fixes, refactorings) for a range
Inputs: file (required), start_line (required), start_column (required), end_line, +1 more.
ada_completionsC
Get code completion suggestions at a position in an Ada file
Inputs: file (required), line (required), column (required), limit, +1 more.
ada_dependency_graphB
Analyze package dependencies from 'with' clauses
Inputs: file (required).
ada_diagnosticsA
Get synchronized compiler diagnostics for one Ada file, or the explicitly incomplete cache of published diagnostics when no file is provided
Inputs: file, severity.
ada_document_symbolsB
Get all symbols defined in an Ada file (outline)
Inputs: file (required).
ada_find_referencesB
Find all references to an Ada symbol across the project
Inputs: file (required), line (required), column (required), include_declaration.
ada_format_fileC
Format an Ada source file using GNATformat
Inputs: file (required), tab_size, insert_spaces.
ada_get_specB
Navigate from body to spec file, or find corresponding spec
Inputs: file (required), line, column.
ada_goto_definitionB
Navigate to the definition of an Ada symbol at a given location
Inputs: file (required), line (required), column (required).
ada_hoverC
Get type information and documentation for an Ada symbol
Inputs: file (required), line (required), column (required).
ada_implementationB
Navigate from declaration to implementation (spec to body)
Inputs: file (required), line (required), column (required).
ada_project_infoA
Select an exact GPR project with an optional per-view environment and return its evaluated structure; later file tools reuse the validated selection
Inputs: gpr_file (required), project_paths, scenario_variables.
ada_rename_symbolC
Rename an Ada symbol across the entire project
Inputs: file (required), line (required), column (required), new_name (required), +1 more.
ada_signature_helpC
Get function/procedure signature help at a position
Inputs: file (required), line (required), column (required).
ada_type_definitionA
Navigate from an object or parameter identifier to its type declaration; use ada_goto_definition on an explicit type name
Inputs: file (required), line (required), column (required).
ada_workspace_symbolsB
Search for symbols by name across the complete indexed Ada workspace
Inputs: file (required), query (required), kind, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools map to clearly distinct LSP-style operations (hover, diagnostics, completions, rename, format, build). There is some potential confusion among the navigation family (ada_goto_definition, ada_type_definition, ada_implementation, ada_get_spec), but the descriptions explicitly clarify their different targets. ada_project_info and ada_alire_info are also somewhat adjacent, though their scopes differ.
All 19 tools share the ada_ prefix and consistent snake_case naming. The style is predictable, with clear action-oriented names (ada_goto_definition, ada_find_references, ada_rename_symbol) and conventional noun-style LSP terms (ada_hover, ada_completions, ada_diagnostics).
Nineteen tools is on the heavy side but appropriate for an Ada language-server integration covering navigation, symbols, completion, diagnostics, refactoring, formatting, build, and project metadata. The surface is broad but each tool has a distinct role.
The set covers the core language-server workflows: navigation, references, symbols, diagnostics, completion, code actions, rename, formatting, build, call hierarchy, dependency graph, and project info. Minor gaps remain around less central LSP features such as document highlights, selection range, semantic tokens, or code lens, but there are no major dead ends for typical Ada development tasks.
Maintenance
Related MCP Connectors
Lean 4 MCP server: compile, prove theorems, and formalize math with Mathlib.
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes Language Server Protocol (LSP) tools such as diagnostics, goto definition, find references, symbols, and rename as a stdio MCP server.8MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to leverage VS Code's language intelligence for code navigation, refactoring, and analysis via the MCP protocol.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides semantic Ada language features like navigation, diagnostics, and code intelligence to AI coding agents by wrapping the Ada Language Server.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with VS Code's language server protocol features (definitions, references, diagnostics) and debugger (breakpoints, stepping, variable inspection) via an MCP server.4 npm1MIT