jamfmcp CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is jamfmcp, an async MCP (Model Context Protocol) server for Jamf Pro integration. It provides tools for computer health analysis, inventory management, and policy monitoring through the Jamf Pro API. The project uses FastMCP to expose Jamf Pro functionality to AI assistants.

Development Commands

Setup and Installation

make install-dev          # Install project with dev dependencies
make venv                 # Create virtual environment only

Testing

make test                 # Run all tests with verbose output
make test-cov             # Run tests with coverage report
make test-cov-html        # Generate HTML coverage report
uv run pytest tests/ -v   # Direct pytest invocation
uv run pytest tests/test_api.py -v   # Run specific test file

Note: The jamfsdk directory is excluded from test discovery and coverage reporting.

Code Quality

make lint                 # Check code style with ruff (format + lint)
make format               # Auto-format code with ruff
make pre-commit           # Install pre-commit hooks
make pre-commit-run       # Run pre-commit on all files

Dependency Management

make lock                 # Update uv.lock file
make upgrade              # Upgrade all dependencies to latest versions

Building

make build                # Build wheel and sdist packages

Cleanup

make clean                # Remove build artifacts and cache files
make flush                # Deep clean (all generated files)
make restore              # Full cleanup (clean + flush)

Architecture

Core Components

1. MCP Server (server.py): FastMCP-based server exposing tools for Jamf Pro API interaction. All tools are async and handle ID parameters as strings or integers for MCP client compatibility.

2. API Client (api.py): JamfApi class wraps the underlying AsyncJamfProClient from jamfsdk. Provides high-level async methods for:

   • Computer inventory and history
   • User and device lookups
   • Policy and configuration profile management
   • JCDS (Jamf Cloud Distribution Service) operations
   • Organizational data (buildings, departments, sites, network segments)