Exarp

MCP Server for Project Management Automation

Install

🚨 For Development: This project uses uv for all package management. See .cursorrules for details.

Using uv (Recommended - Faster):

# For end users installing from PyPI
uv pip install exarp

# For developers working on this repo
uv sync

Using pip (Fallback - Not recommended for development):

pip install exarp

Quick Start

# Run the MCP server
exarp

# Or use aliases
pma
python -m project_management_automation.server

MCP Client Configuration

Add to your MCP client config (Cursor, Claude Desktop, VS Code):

{
  "mcpServers": {
    "exarp": {
      "command": "/path/to/project-management-automation/exarp-uvx-wrapper.sh",
      "args": ["--mcp"]
    }
  }
}

Recommended: Use exarp-uvx-wrapper.sh which automatically detects uvx location across platforms (Ubuntu, macOS Intel/Apple Silicon).

Alternative: If uvx is in your PATH, use directly:

{
  "mcpServers": {
    "exarp": {
      "command": "uvx",
      "args": ["exarp", "--mcp"]
    }
  }
}

See UVX Location Guide for detailed platform-specific instructions.

Development

Keeping MCP Features in Sync

This project supports both FastMCP and stdio server interfaces. When adding tools, resources, or prompts, you must register them in both systems.

📖 See MCP Sync Guide for complete instructions.

Quick check:

uv run python scripts/verify_mcp_sync.py

Features

🏥 Project Health

📚 Documentation

✅ Task Management

🔒 Security

🤖 Automation

🔧 CI/CD & Git

🧪 Testing

ZSH Plugin

For shell integration with context-aware project health:

# Add to ~/.zshrc
source /path/to/exarp.plugin.zsh

# Commands
xl   # Quick context (no Python needed)
xc   # Full context with score
xs   # Project scorecard
xo   # Project overview
xt   # List pending tasks
xp   # Scan for projects
motd # Daily wisdom

See shell/exarp.plugin.zsh for full documentation.

Daily Wisdom

Exarp includes optional daily wisdom quotes based on project health:

# Configure source
export EXARP_WISDOM_SOURCE=stoic  # or: bofh, tao, bible, murphy, shakespeare, sefaria

# Disable
export EXARP_WISDOM_DISABLED=1

Man Pages

man exarp       # MCP server documentation
man exarp-zsh   # ZSH plugin documentation

Requirements

• Python 3.9+
• FastMCP 2.0+
• Pydantic 2.0+

Links

• PyPI: https://pypi.org/project/exarp/
• GitHub: https://github.com/davidl71/project-management-automation
• Issues: https://github.com/davidl71/project-management-automation/issues

License

MIT License - see LICENSE

Attributions

This project includes features inspired by third-party projects:

• Git-Inspired Task Management: Concepts inspired by GitTask (GPL-3.0). See ATTRIBUTIONS.md for details.

All implementations are original code. No third-party code was copied.