Quickstart

Install

uv add lexigram-ai-mcp

lexigram-ai-mcp depends on lexigram and lexigram-contracts (installed automatically).

Minimal MCP Server

import asyncio

from lexigram import Application, LexigramConfig
from lexigram.ai.mcp import MCPModule


async def main() -> None:
    config = LexigramConfig.from_yaml("application.yaml")
    app = Application(name="my-mcp-app", config=config)
    app.add_module(MCPModule.configure())
    await app.start()

    # MCPServer is now wired and ready
    print("MCP server is running")

    await app.stop()


asyncio.run(main())

With application.yaml:

ai_mcp:
  host: "0.0.0.0"
  port: 8080
  path: "/mcp"

What Just Happened

MCPModule.configure() creates a DynamicModule with an MCPProvider.
Application.boot() starts the provider lifecycle:
- register — MCPConfig is bound in the container.
- boot — handlers, connectors, transports, and the MCPServer are wired.
The server listens for JSON-RPC messages over HTTP+SSE or stdio.

Next Steps

Guide — mental model, tools/resources/prompts, client usage
How-Tos — task-oriented recipes
Configuration — all config keys and env-var overrides