jamfmcp 1.0.0

An async MCP server for Jamf Pro integration providing computer health analysis

JamfMCP

⚠️ Important ⚠️

This project is currently in active development and should be considered alpha-quality software. The API, features, and functionality are subject to change without notice. Users should expect:

• Breaking changes between versions
• Incomplete features and documentation
• Potential bugs and unexpected behavior
• API endpoints and tool signatures may change

Use in production environments at your own risk. Contributions and feedback are welcome!

An async MCP (Model Context Protocol) server for Jamf Pro integration, providing AI assistants with tools for computer health analysis, inventory management, and policy monitoring.

Features

• Computer Health Analysis: Generate comprehensive health scorecards with security compliance, CVE analysis, and system diagnostics
• Inventory Management: Search and retrieve detailed computer inventory information
• Policy & Configuration: Access policies, configuration profiles, scripts, and packages
• Security Intelligence: Integrate with macadmins SOFA feed for macOS security vulnerability tracking
• Organizational Data: Query buildings, departments, sites, network segments, and more
• Async Architecture: Built with modern async Python for high performance
• Flexible Authentication: Support for both basic auth and OAuth client credentials

Installation

pip install jamfmcp

Quick Setup

Use the JamfMCP CLI tool for automated setup:

# For Claude Desktop
jamfmcp setup -p claude-desktop

# For Cursor
jamfmcp setup -p cursor

# For other platforms
jamfmcp setup -p <platform>

The CLI will guide you through the entire configuration process.

Documentation

For detailed installation, configuration, and usage instructions, please visit the full documentation.

Key Documentation Sections:

• Getting Started - Installation and prerequisites
• CLI Setup Guide - Automated configuration tool
• Quickstart Guide - Example queries and workflows
• Configuration - Platform-specific setup
• Troubleshooting - Common issues and solutions

Important Notes for Claude Desktop Users

Claude Desktop requires uv to be installed via Homebrew on macOS. See the prerequisites documentation for critical setup requirements.

Basic Usage

Once configured, you can ask your AI assistant questions like:

• "Generate a health scorecard for computer with serial ABC123"
• "Find all computers that haven't checked in for 30 days"
• "What CVEs affect computers running macOS 14.5?"
• "List all configuration profiles and their scope"

Development

For contributors and developers:

# Clone and install for development
git clone https://github.com/liquidz00/jamfmcp.git
cd jamfmcp
make install-dev

# Run tests
make test

# For local development setup
jamfmcp setup -p <platform> --local

See the development documentation for detailed contribution guidelines.

Support

• Documentation: liquidz00.github.io/jamfmcp
• Issues: GitHub Issues
• Discussions: MacAdmins Slack #jamfmcp

Contributing

Contributions are welcome! Please see our contributing guide for details.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Acknowledgments

• Built with FastMCP
• Security intelligence from macadmins SOFA
• Jamf Pro API documentation: developer.jamf.com