liquidz00/jamfmcp
If you are the rightful owner of jamfmcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
JamfMCP is an async Model Context Protocol server designed for integration with Jamf Pro, offering AI-driven tools for computer health analysis, inventory management, and policy monitoring.
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: Project Docs
- 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 file for details.
Acknowledgments
- Built with FastMCP
- Security intelligence from macadmins SOFA
- Jamf Pro API documentation: developer.jamf.com