pyro-mcp/AGENTS.md

AGENTS.md

Repository guidance for contributors and coding agents.

Purpose

This repository ships pyro-mcp, a minimal MCP-compatible Python package with a static tool for demonstration and testing.

Development Workflow

• Use uv for all Python environment and command execution.
• Run make setup after cloning.
• Run make check before opening a PR.
• Use make demo to verify the static tool behavior manually.
• Use make ollama-demo to validate model-triggered tool usage with Ollama.

Quality Gates

• Linting: ruff
• Type checking: mypy (strict mode)
• Tests: pytest with coverage threshold

These checks run in pre-commit hooks and should all pass locally.

Key API Contract

• Public factory: pyro_mcp.create_server()
• Tool name: hello_static
• Tool output:
  • message: hello from pyro_mcp
  • status: ok
  • version: 0.0.1