OpticMCP - Agent Guidelines

Commands

OpenCV prints to stderr which corrupts MCP stdio. Always suppress stderr at fd level BEFORE importing cv2 (see

_suppress_opencv_stderr()

in src/optic_mcp/server.py).

When adding camera/vision tools, use the

@mcp.tool()

decorator. Tools should return JSON-serializable data or base64-encoded images for binary data.

OpenCV prints to stderr which corrupts MCP stdio. Always suppress stderr at fd level BEFORE importing cv2 (see

_suppress_opencv_stderr()

in src/optic_mcp/server.py).

When adding camera/vision tools, use the

@mcp.tool()

decorator. Tools should return JSON-serializable data or base64-encoded images for binary data.