lokryn-mcp-log

# lokryn-mcp-log Compliance-grade audit logging for MCP (Model Context Protocol) client operations. ## What It Does Wraps the official MCP Python SDK's `ClientSession` and logs every operation—tool calls, resource access, prompt executions—in a format that satisfies SOC2, HIPAA, and PCI audit requirements. Logs conform to the lokryn-compliance-log-schema, an open standard for audit logging (schema vendored in this package, will be extracted to separate PyPI package). ## Installation ```bash pip install lokryn-mcp-log ``` Or with uv: ```bash uv add lokryn-mcp-log ``` ## Quick Start ```python from mcp import ClientSession, StdioServerParameters from mcp.client.stdio import stdio_client from lokryn_mcp_log import with_logging, StdoutSink server_params = StdioServerParameters(command="python", args=["server.py"]) async def main(): async with stdio_client(server_params) as (read, write): async with ClientSession(read, write) as session: await session.initialize() # Wrap with logging logged = with_logging( session, sink=StdoutSink(), environment="development", ) # Use exactly like normal await logged.call_tool("add", {"a": 1, "b": 2}) ``` ## Sinks ### StdoutSink ```python from lokryn_mcp_log import StdoutSink sink = StdoutSink() # JSON to stdout sink = StdoutSink(pretty=True) # Pretty-printed ``` ### FileSink ```python from lokryn_mcp_log import FileSink sink = FileSink("/var/log/mcp-audit.jsonl") ``` ### HTTPSink ```python import os from lokryn_mcp_log import HTTPSink # JSON format (default) sink = HTTPSink( endpoint="https://your-log-collector.com/ingest", headers={"Authorization": "Bearer <token>"}, ) # Protobuf format sink = HTTPSink( endpoint="https://your-log-collector.com/ingest/proto", format="protobuf", ) # With HMAC signing sink = HTTPSink( endpoint="https://your-log-collector…