slim-MCP CLAUDE.md

Claude Tools Project Guide

Environment Setup & Run Commands

# Create conda environment with Python 3.11
conda create -n mcp-tools python=3.11

# Activate environment
conda activate mcp-tools

# Install with uv (preferred)
uv pip install -e .

# Alternative: Install with pip
pip install -e .

# Run the application
python -m claude_tools.main

Configuration

Claude Config

{
    "mcpServers": {
        "claude-tools": {
            "command": "/Users/jasonbrashear/miniconda3/envs/claude-tools/bin/python",
            "args": ["-m", "claude_tools.main"]
        }
    }
}

Cursor Config

NAME: claude-tools
TYPE: command
COMMAND: /Users/jasonbrashear/miniconda3/envs/claude-tools/bin/python -m claude_tools.main

Code Style Guidelines

• Follow PEP 8 conventions
• Use Google-style docstrings for functions and classes
• Type annotations required for all function parameters and return values
• Constants defined at module level in UPPER_CASE
• Imports ordered: standard library, third-party, local
• Error handling: use try/except blocks with specific exceptions
• Function names use snake_case
• Class names use PascalCase
• Prefer async/await for I/O operations
• Each tool function should have a clear single responsibility
• Use meaningful variable names that describe purpose