How merill/lokka works
Lokka is an MCP server that lets an AI client query and manage Microsoft Graph and Azure Resource Manager through natural-language tool calls. The main runtime registers and handles tools, selects an API path, and performs requests; authentication is provided by a separate auth manager supporting interactive, certificate, client-secret, and client-supplied-token modes. Token management, permission requests, Graph-version selection, and paginated responses are part of this runtime. Source excerpts show the main request and auth wiring; some tool-registration details are only documented in the README.
Main entry points: main.ts MCP server runtime · auth.ts Auth manager · logger.ts Logger · constants.ts Auth configuration
Components 15
MCP runtime
- MCP server runtime
src/mcp/src/main.ts - stdio transport
src/mcp/src/main.ts - API request tool
src/mcp/src/main.ts - Token management tools
src/mcp/src/main.ts - Permission request tool
src/mcp/src/main.ts - Logger
src/mcp/src/logger.ts
Authentication
- Auth manager
src/mcp/src/auth.ts - Auth configuration
src/mcp/src/constants.ts
API requests
- Graph requests
src/mcp/src/main.ts - Azure RM requests
src/mcp/src/main.ts
External systems
- Microsoft Graph API
- Azure Resource Manager API
- Azure Identity SDK
- MCP SDK
Other components
- AI MCP client
Connections 17
- AI MCP client → stdio transport: connects over
README.md - stdio transport → MCP server runtime: starts runtime
src/mcp/src/main.ts - MCP server runtime → API request tool: registers tools
README.md - MCP server runtime → Token management tools: registers tools
README.md - MCP server runtime → Permission request tool: registers tools
README.md - API request tool → Graph requests: dispatches Graph
src/mcp/src/main.ts - API request tool → Azure RM requests: dispatches Azure
src/mcp/src/main.ts - Graph requests → Microsoft Graph API: sends requests
src/mcp/src/main.ts - Azure RM requests → Azure Resource Manager API: fetches requests
src/mcp/src/main.ts - MCP server runtime → Auth manager: initializes
src/mcp/src/main.ts - Auth manager → Azure Identity SDK: creates credentials
src/mcp/src/auth.ts - MCP server runtime → Microsoft Graph API: initializes Graph client
src/mcp/src/main.ts - Token management tools → Auth manager: updates token
src/mcp/src/main.ts - Permission request tool → Auth manager: refreshes credentials
src/mcp/src/main.ts - Auth manager → Auth configuration: uses defaults
src/mcp/src/auth.ts - MCP server runtime → MCP SDK: creates server
src/mcp/src/main.ts - MCP server runtime → Logger: logs runtime
src/mcp/src/main.ts