# Amicus MCP Installation Guide
## Installation using `uv` (Recommended)
Amicus is optimized for installation with `uv`, a modern Python package manager.
```bash
# Install tool
uv tool install . --force
```
This will expose the `amicus-mcp` command globally (or in your tool environment).
## Manual Installation
```bash
# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install editable
pip install -e .
```
## Configuring Claude Desktop
To use Amicus with Claude Desktop, add it to your `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"amicus": {
"command": "uv",
"args": [
"tool",
"run",
"amicus-mcp"
],
"env": {
"CONTEXT_BUS_DIR": "/absolute/path/to/your/project/.ai"
}
}
}
}
```
*Note: Replace `/absolute/path/to/your/project/.ai` with the actual path you want to use for state storage, or omit `env` to default to the current working directory (though CWD might be unpredictable in some MCP clients).*
## Verification
After installation, verify the tool is working:
```bash
amicus-mcp --validate-env
```
If you see `✓ Environment validation complete`, you are ready to go.
