lexigram-ai-mcp 0.1.1

MCP Server for Lexigram Framework - Model Context Protocol server for AI agents

lexigram-ai-mcp

MCP Server for Lexigram Framework - Model Context Protocol server for AI agents

---

Overview

Model Context Protocol (MCP) server and client implementation for the Lexigram Framework. Exposes tools, resources, and prompts to any MCP-compatible client — including Claude Desktop, Cursor, and custom AI agents — over SSE or stdio transports. Also provides MCP client connectivity for consuming external MCP servers. Zero-config usage starts with sensible defaults.

Full documentation: docs.lexigram.dev

Install

uv add lexigram-ai-mcp

Quick Start

from lexigram import Application
from lexigram.di.module import Module, module

from lexigram.ai.mcp import MCPModule
from lexigram.ai.mcp.config import MCPConfig

@module(imports=[
    MCPModule.configure(
        config=MCPConfig(
            server_name="my-app",
            server_version="1.0.0",
            enable_sse=True,
            stdio_mode=False,
        )
    )
])
class AppModule(Module):
    pass

app = Application(modules=[AppModule])
if __name__ == "__main__":
    app.run()

Configuration

Zero-config usage: Call MCPModule.configure() with no arguments to use defaults.

Option 1 — YAML file

# application.yaml
ai_mcp:
  host: "0.0.0.0"
  port: 8080
  path: "/mcp"
  enable_sse: true
  server_name: "lexigram-mcp"
  server_version: "1.0.0"

Option 2 — Profiles + Environment Variables (recommended)

export LEX_AI_MCP__ENABLED=true
export LEX_AI_MCP__HOST=0.0.0.0
# Environment variables for each field

Option 3 — Python

from lexigram.ai.mcp.config import MCPConfig
from lexigram.ai.mcp import MCPModule

config = MCPConfig(
    enabled=True,
    host="0.0.0.0",
    port=8080,
    enable_sse=True,
    server_name="my-app",
)
MCPModule.configure(config)

Config reference

Field	Default	Env var	Description
enabled	True	LEX_AI_MCP__ENABLED	Enable the MCP server subsystem
host	"0.0.0.0"	LEX_AI_MCP__HOST	Host to bind (HTTP transport)
port	8080	LEX_AI_MCP__PORT	Port to bind (HTTP transport)
path	"/mcp"	LEX_AI_MCP__PATH	URL path for MCP endpoint
enable_sse	True	LEX_AI_MCP__ENABLE_SSE	Enable Server-Sent Events transport
stdio_mode	False	LEX_AI_MCP__STDIO_MODE	Use stdio transport instead of HTTP
server_name	"lexigram-mcp"	LEX_AI_MCP__SERVER_NAME	MCP server name
server_version	"1.0.0"	LEX_AI_MCP__SERVER_VERSION	MCP server version
cors_origins	[]	LEX_AI_MCP__CORS_ORIGINS	CORS allowed origins
max_request_size	1048576	LEX_AI_MCP__MAX_REQUEST_SIZE	Max request size (bytes)
request_timeout	30.0	LEX_AI_MCP__REQUEST_TIMEOUT	Request timeout (seconds)

Module Factory Methods

Method	Description
MCPModule.configure(config, controllers, services)	Configure with explicit config
MCPModule.from_services(services, include_methods)	Auto-expose service methods as MCP tools
MCPModule.stub()	Minimal config for testing
MCPClientModule.configure(connections)	Configure MCP client connections

Key Features

• Server: Define tools using decorators (@tool, @resource, @prompt)
• Controllers: Group related tools via MCPController
• Auto-expose: Wire service methods as MCP tools
• Transports: SSE and stdio transport support
• Built-in connectors: Filesystem, GitHub, WebFetch, WebSearch, Slack, GoogleDrive, SQL
• Client: Connect to external MCP servers
• Adapters: Bridge to lexigram-ai-agents and lexigram-ai-skills

Testing

async with Application.boot(modules=[MCPModule.stub()]) as app:
    # your test code
    ...

Key Source Files

File	What it contains
src/lexigram/ai/mcp/module.py	MCPModule.configure(), from_services(), stub()
src/lexigram/ai/mcp/config.py	MCPConfig and connector config classes
src/lexigram/ai/mcp/server/core.py	MCPServer — protocol implementation
src/lexigram/ai/mcp/client/module.py	MCPClientModule.configure()
src/lexigram/ai/mcp/transport/sse.py	SSE transport (HTTP-based)
src/lexigram/ai/mcp/transport/stdio.py	Stdio transport (subprocess-based)
src/lexigram/ai/mcp/controllers/base.py	MCPController base class
src/lexigram/ai/mcp/di/provider.py	MCPProvider — registers MCP into DI