REPO-SYNCED ADAPTER DOC

MCP-AQL Reference Adapter

Reference implementation for MCP-AQL (Model Context Protocol - Advanced Agent API Adapter Query Language) adapters.

Repository source

Source: mcpaql-adapter/README.md

Open Source MarkdownBrowse Reference Adapter DocsAdapter Patterns Hub

On this page

Jump to a section

Use the outline to move through longer pages without losing your place.

  1. Purpose
  2. Documentation
  3. Architecture
  4. Guides
  5. Architecture Decision Records
  6. Examples
  7. Relationship to Spec
  8. Related Repositories
  9. License

Reference implementation for MCP-AQL (Model Context Protocol - Advanced Agent API Adapter Query Language) adapters.

Purpose

This repository contains the implementation architecture documentation and reference adapter code for the MCP-AQL protocol. It provides:

  • Implementation guidance for building MCP-AQL adapters
  • Architecture documentation for the universal adapter runtime
  • Plugin system implementation details
  • Development guides and patterns

For normative protocol specifications (wire format, schema semantics, interface contracts), see the spec repository.

Documentation

Architecture

Document Description
Architecture Overview How adapters work internally
Universal Runtime Schema interpreter execution engine
Plugin System Plugin composition and MVP implementations
Schema-Driven Dispatch Declarative operation dispatch pattern

Guides

Document Description
Development Guide How to build MCP-AQL adapters
Testing Guide Testing patterns for adapters
Migration Guide Migrating from MCP server to MCP-AQL adapter

Architecture Decision Records

ADR Title
ADR-001 Plugin Pipeline Order
ADR-002 Schema-Driven Dispatch over Code Generation
ADR-003 Stateless Singleton Plugins

Examples

Example Description
Minimal Adapter Bare-minimum adapter with introspection
User Management Full CRUDE adapter with all endpoints

Relationship to Spec

This repository contains Level 4 content (implementation guidance) from the MCP-AQL four-level protocol model:

Level What Lives in
1. Wire format Request/response JSON, error codes, introspection spec
2. Schema semantics Operation declarations, params, auth, target spec
3. Canonical format Markdown + YAML front matter interchange format spec
4. Implementation guidance Runtime architecture, plugin pipeline, dispatch this repo
Repository Purpose
spec Protocol specification, schemas, conformance tests
examples Example adapter configurations
adapter-generator Tool to generate adapters from API specs

License

  • Documentation: CC BY 4.0
  • Code/schemas/tests: AGPL-3.0

See LICENSING for details.