# Homebrew Formula Research: MCP Tools Suite
**Research Date**: 2025-11-24
**Researcher**: Research Agent
**Purpose**: Gather PyPI and GitHub information for creating Homebrew formulas
---
## Executive Summary
All four tools (claude-mpm, mcp-vector-search, mcp-ticketer, mcp-skillset) are published on PyPI and ready for Homebrew packaging. Three already have existing Homebrew taps in development.
**Key Findings**:
- ✅ All tools available on PyPI
- ✅ All tools have active GitHub repositories (MIT licensed)
- ✅ 3/4 tools already have Homebrew taps (claude-mpm, mcp-vector-search, mcp-ticketer)
- ✅ All tools have well-defined CLI entry points
- ⚠️ Python version requirements vary (3.8 to 3.11+)
---
## Tool 1: claude-mpm
### PyPI Information
- **Status**: ✅ Published
- **Package Name**: `claude-mpm`
- **Latest Version**: 4.26.1
- **PyPI URL**: https://pypi.org/project/claude-mpm/
- **Source Distribution**: https://files.pythonhosted.org/packages/97/17/f1dc95379984c7b06c918a320d86c4b613dabf6392e80394f5cfd11f564c/claude_mpm-4.26.1.tar.gz
- **SHA256**: `3d25c576e1d63bcca34387693807201bfafd5c0888f50f6e7dc86e9eb3f38a49`
- **Package Size**: 7,282,449 bytes (~7.3 MB)
### GitHub Repository
- **URL**: https://github.com/bobmatnyc/claude-mpm
- **Description**: Claude Multi-Agent Project Manager - Subprocess orchestration layer for Claude
- **License**: MIT License
- **Stars**: 22
- **Status**: Active (Updated: 2025-11-25T03:50:33Z)
- **Archived**: No
### Technical Details
- **Python Requirement**: >=3.8
- **CLI Command**: `claude-mpm`
- **Additional Commands**:
- `claude-mpm-ticket` / `ticket`
- `claude-mpm-version`
- `claude-mpm-monitor`
- `claude-mpm-socketio`
- `claude-mpm-mcp`
- `claude-mpm-mcp-wrapper`
- `claude-mpm-doctor`
### Key Dependencies
- ai-trackdown-pytools>=1.4.0
- pyyaml>=6.0
- python-dotenv>=0.19.0
- click>=8.0.0
- pexpect>=4.8.0
- psutil>=5.9.0
- requests>=2.25.0
- flask>=3.0.0
- flask-cors>=4.0.0
- watchdog>=3.0.0
- python-socketio>=5.14.0
- aiohttp>=3.9.0
- pydantic>=2.0.0
- rich>=13.0.0
- kuzu-memory>=1.1.5
### Homebrew Status
- **Existing Tap**: ✅ `bobmatnyc/claude-mpm/claude-mpm`
- **Local Path**: /Users/masa/Projects/homebrew-claude-mpm
- **Status**: Formula exists and maintained
---
## Tool 2: mcp-vector-search
### PyPI Information
- **Status**: ✅ Published
- **Package Name**: `mcp-vector-search`
- **Latest Version**: 0.12.8
- **PyPI URL**: https://pypi.org/project/mcp-vector-search/
- **Source Distribution**: https://files.pythonhosted.org/packages/93/c5/dc86d1ab76992beee690f2df31d1b2ec3b97c5159d57a38a5d3223778b0c/mcp_vector_search-0.12.8.tar.gz
- **SHA256**: `18a0ce0d65b6a49d5fd5d22be4c74018cbe5f72fcbc03facdd3ea98924d6aa3f`
- **Package Size**: 610,236 bytes (~610 KB)
### GitHub Repository
- **URL**: https://github.com/bobmatnyc/mcp-vector-search
- **Description**: CLI-first semantic code search with MCP integration. Modern, fast, and intelligent code search powered by ChromaDB and AST parsing.
- **License**: MIT License
- **Stars**: 3
- **Status**: Active (Updated: 2025-11-19T21:19:36Z)
- **Archived**: No
- **Documentation**: https://mcp-vector-search.readthedocs.io
### Technical Details
- **Python Requirement**: >=3.11
- **CLI Command**: `mcp-vector-search`
- **Build System**: Hatchling
### Key Dependencies
- chromadb>=0.5.0
- sentence-transformers>=2.2.2
- tree-sitter>=0.20.1
- tree-sitter-language-pack>=0.9.0
- typer>=0.9.0
- rich>=13.0.0
- pydantic>=2.5.0
- pydantic-settings>=2.1.0
- watchdog>=3.0.0
- aiofiles>=23.0.0
- loguru>=0.7.0
- httpx>=0.25.0
- mcp>=1.12.4
- click-didyoumean>=0.3.0
- packaging>=23.0
- authlib>=1.6.4
### Homebrew Status
- **Existing Tap**: ✅ `bobmatnyc/mcp-vector-search/mcp-vector-search`
- **Local Path**: /Users/masa/Projects/homebrew-mcp-vector-search
- **Status**: Formula exists and maintained
---
## Tool 3: mcp-ticketer
### PyPI Information
- **Status**: ✅ Published
- **Package Name**: `mcp-ticketer`
- **Latest Version**: 1.2.10
- **PyPI URL**: https://pypi.org/project/mcp-ticketer/
- **Source Distribution**: https://files.pythonhosted.org/packages/49/7f/11fa6f23eb87d3558558bb1ac0dc5c7a35fdd7b06e6b9e5a975f4cc62d6b/mcp_ticketer-1.2.10.tar.gz
- **SHA256**: `c2667031af2accfadd90d52b18a25424e632442b7cacf297dfb512aa48d40d5d`
- **Package Size**: 1,714,713 bytes (~1.7 MB)
### GitHub Repository
- **URL**: https://github.com/bobmatnyc/mcp-ticketer (Note: PyPI lists mcp-ticketer/mcp-ticketer, but existing formula uses bobmatnyc)
- **Description**: Universal ticket management interface for AI agents with MCP support
- **License**: MIT
- **Documentation**: https://mcp-ticketer.readthedocs.io
- **Status**: Active
### Technical Details
- **Python Requirement**: >=3.10
- **CLI Command**: `mcp-ticketer`
- **Build System**: Setuptools with setuptools-scm
### Key Dependencies
- gql[httpx]>=3.0.0
- httpx>=0.25.0
- mcp>=1.2.0
- psutil>=5.9.0
- pydantic>=2.0
- python-dotenv>=1.0.0
- pyyaml>=6.0.0
- rich>=13.0.0
- tomli>=2.0.0 (Python <3.11)
- tomli-w>=1.0.0
- typer>=0.9.0
- typing-extensions>=4.8.0
### Optional Dependencies
- **jira**: jira>=3.5.0, ai-trackdown-pytools>=1.5.0
- **linear**: gql[httpx]>=3.0.0
- **github**: PyGithub>=2.1.0
- **analysis**: scikit-learn>=1.3.0, rapidfuzz>=3.0.0, numpy>=1.24.0
### Homebrew Status
- **Existing Tap**: ✅ `bobmatnyc/mcp-ticketer/mcp-ticketer`
- **Local Path**: /Users/masa/Projects/homebrew-mcp-ticketer
- **Formula Version**: 1.1.8 (outdated, latest is 1.2.10)
- **Status**: Formula exists but needs version update
---
## Tool 4: mcp-skillset
### PyPI Information
- **Status**: ✅ Published
- **Package Name**: `mcp-skillset`
- **Latest Version**: 0.5.1
- **PyPI URL**: https://pypi.org/project/mcp-skillset/
- **Source Distribution**: https://files.pythonhosted.org/packages/b6/18/eebeb1e068a1679dcc87b57420dad8771d0bc51daa1c415437d5b1e29218/mcp_skillset-0.5.1.tar.gz
- **SHA256**: `de320ea9b26de2f9aff530f4b1b9dafefc5daf915229a7b7da970928eea90c94`
- **Package Size**: 101,873 bytes (~102 KB)
### GitHub Repository
- **URL**: https://github.com/bobmatnyc/mcp-skillset
- **Description**: Dynamic RAG-powered skills service for code assistants via MCP - Vector + Knowledge Graph hybrid search for intelligent skill discovery
- **License**: MIT License
- **Stars**: 1
- **Status**: Active (Updated: 2025-11-25T04:32:22Z)
- **Archived**: No
### Technical Details
- **Python Requirement**: >=3.11
- **CLI Command**: `mcp-skillset`
- **Build System**: Setuptools
### Key Dependencies
- click>=8.0
- pydantic>=2.0
- pydantic-settings>=2.0
- pyyaml>=6.0
- rich>=13.0.0
- mcp>=0.1.0
- chromadb>=0.4.0
- sentence-transformers>=2.2.0
- networkx>=3.0
- sqlalchemy>=2.0
- gitpython>=3.1.0
- python-frontmatter>=1.0.0
- watchdog>=3.0.0
- questionary>=2.0.1
- pyperclip>=1.8.2
### Optional Dependencies
- **qdrant**: qdrant-client>=1.7.0
- **neo4j**: neo4j>=5.0.0
### Homebrew Status
- **Existing Tap**: ✅ `bobmatnyc/mcp-skillset/mcp-skillset`
- **Local Path**: /Users/masa/Projects/homebrew-mcp-skillset
- **Status**: Formula exists and maintained
---
## Python Version Compatibility Matrix
| Tool | Min Python | Optimal Python | Notes |
|------|-----------|---------------|-------|
| claude-mpm | 3.8 | 3.11 | Broadest compatibility |
| mcp-vector-search | 3.11 | 3.12 | Requires modern Python |
| mcp-ticketer | 3.10 | 3.12 | Mid-range requirement |
| mcp-skillset | 3.11 | 3.12 | Requires modern Python |
### Homebrew Python Dependency Recommendation
- Use `python@3.11` for maximum compatibility across all tools
- All tools support Python 3.11+
- Python 3.12 is optimal for newer tools but not required
---
## Homebrew Tap Structure Recommendations
### Current State
Each tool has its own tap:
- `bobmatnyc/claude-mpm`
- `bobmatnyc/mcp-vector-search`
- `bobmatnyc/mcp-ticketer`
- `bobmatnyc/mcp-skillset`
### Recommended Consolidated Structure
**Option 1: Single Unified Tap**
```
bobmatnyc/homebrew-mcp-tools
├── Formula/
│ ├── claude-mpm.rb
│ ├── mcp-vector-search.rb
│ ├── mcp-ticketer.rb
│ └── mcp-skillset.rb
└── README.md
```
**Installation**: `brew install bobmatnyc/mcp-tools/<tool-name>`
**Benefits**:
- Single tap to maintain
- Easier discovery (one tap, multiple tools)
- Consistent versioning and updates
- Shared CI/CD pipeline
**Option 2: Keep Individual Taps (Current)**
- More granular control
- Independent versioning
- Users only install what they need
- More repos to maintain
### Recommendation: **Option 1 (Unified Tap)**
Consolidate into `bobmatnyc/homebrew-mcp-tools` for easier maintenance and discovery.
---
## Action Items
### Immediate (Ready for Homebrew)
1. ✅ **claude-mpm**: Formula exists and up-to-date (4.26.1)
2. ✅ **mcp-vector-search**: Formula exists and up-to-date (0.12.8)
3. ⚠️ **mcp-ticketer**: Update formula from 1.1.8 to 1.2.10
4. ✅ **mcp-skillset**: Formula exists and up-to-date (0.5.1)
### Strategic (Tap Consolidation)
1. Create `bobmatnyc/homebrew-mcp-tools` repository
2. Migrate all formulas to unified tap
3. Add deprecation notices to individual taps
4. Update documentation to point to unified tap
5. Set up automated formula updates (GitHub Actions)
### Testing Checklist (Per Tool)
```bash
# Installation
brew install bobmatnyc/mcp-tools/<tool-name>
# Version check
<tool-name> --version
# Help text
<tool-name> --help
# Basic functionality
<tool-name> <basic-command>
# Uninstall
brew uninstall <tool-name>
```
---
## Dependencies Analysis
### Shared Dependencies (Potential for Optimization)
All tools share these dependencies:
- **pydantic**: All use >=2.0
- **rich**: All use >=13.0.0
- **pyyaml**: 3/4 tools (claude-mpm, mcp-ticketer, mcp-skillset)
- **mcp**: 3/4 tools (mcp-vector-search, mcp-ticketer, mcp-skillset)
- **watchdog**: 3/4 tools (claude-mpm, mcp-vector-search, mcp-skillset)
### Heavy Dependencies (Formula Considerations)
- **chromadb**: Used by mcp-vector-search and mcp-skillset (large dependency)
- **sentence-transformers**: Used by mcp-vector-search and mcp-skillset
- **flask**: Used by claude-mpm (web dashboard)
- **tree-sitter**: Used by claude-mpm and mcp-vector-search
### Native Dependencies
- **libyaml**: Required for PyYAML (already handled in mcp-ticketer formula)
- Consider adding for all formulas using PyYAML
---
## License Compliance
All tools are **MIT Licensed** - compatible with Homebrew and permissive for redistribution.
---
## Next Steps
1. **Update mcp-ticketer formula** to version 1.2.10
2. **Test all formulas** on clean macOS installation
3. **Consider tap consolidation** to `homebrew-mcp-tools`
4. **Set up CI/CD** for automated formula updates
5. **Document installation** in main project READMEs
---
## Research Methodology
### Tools Used
- PyPI JSON API (`https://pypi.org/pypi/<package>/json`)
- GitHub API (`https://api.github.com/repos/<owner>/<repo>`)
- Homebrew CLI (`brew search <package>`)
- Local repository inspection (pyproject.toml files)
### Files Analyzed
- `/Users/masa/Projects/claude-mpm/pyproject.toml`
- `/Users/masa/Projects/mcp-vector-search/pyproject.toml`
- `/Users/masa/Projects/mcp-ticketer/pyproject.toml`
- `/Users/masa/Projects/mcp-skillset/pyproject.toml`
- `/Users/masa/Projects/homebrew-mcp-ticketer/Formula/mcp-ticketer.rb`
### Data Sources
- PyPI (package metadata and checksums)
- GitHub (repository status and stars)
- Local development directories (dependency analysis)
- Existing Homebrew formulas (current state)
---
**Research Complete**: 2025-11-24
**Total Tools Researched**: 4/4
**PyPI Availability**: 4/4 (100%)
**Homebrew Readiness**: 4/4 (100%)
**Recommended Action**: Update mcp-ticketer formula, then consolidate taps
