Skip to main content
Glama
Ada MCP Server

Ada MCP Server

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.

  1. 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.

  2. Use the bundled MCP query client, or prepare your client's stdio connection. Native client integration is experimental and needs checks in that client.

  3. 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 tools
ada_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

    A3.5/5.0

    Scored across 19 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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).

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes Language Server Protocol (LSP) tools such as diagnostics, goto definition, find references, symbols, and rename as a stdio MCP server.
      8
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to leverage VS Code's language intelligence for code navigation, refactoring, and analysis via the MCP protocol.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides semantic Ada language features like navigation, diagnostics, and code intelligence to AI coding agents by wrapping the Ada Language Server.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      1
      MIT