# Quick Start Guide

Get the MCP Context Provider running in 5 minutes with this step-by-step guide.

## Overview

The MCP Context Provider gives Claude persistent memory across chat sessions. Instead of losing context when you restart Claude Desktop, your tool preferences, syntax rules, and best practices persist automatically.

## Prerequisites

- **Python 3.8+** (check with `python --version`)
- **Claude Desktop** installed and working
- **Internet connection** for downloading dependencies

## Installation Methods

### 🚀 Option 1: Automated Installation (Recommended)

**For Linux/macOS/Unix:**
```bash
# One-line install
curl -sSL https://raw.githubusercontent.com/doobidoo/MCP-Context-Provider/main/install.sh | bash
```

**For Windows:**
```powershell
# Download and run installer
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/doobidoo/MCP-Context-Provider/main/install.bat" -OutFile "install.bat"
.\install.bat
```

**What it does:**
- ✅ Downloads the MCP Context Provider package
- ✅ Creates a Python virtual environment  
- ✅ Installs all dependencies
- ✅ Configures Claude Desktop automatically
- ✅ Verifies the installation

**Skip to Step 4** if using automated installation.

### 🔧 Option 2: Manual Installation

#### Step 1: Install Prerequisites

**Install DXT CLI:**
```bash
npm install -g @anthropic-ai/dxt
```

**Verify installation:**
```bash
dxt --version
python --version  # Should be 3.8+
```

#### Step 2: Download and Extract

```bash
# Download the DXT package
wget https://github.com/doobidoo/MCP-Context-Provider/raw/main/mcp-context-provider-1.2.1.dxt

# Extract to your preferred location
dxt unpack mcp-context-provider-1.2.1.dxt ~/mcp-context-provider
cd ~/mcp-context-provider
```

#### Step 3: Set Up Python Environment

```bash
# Create virtual environment
python -m venv venv

# Activate it
source venv/bin/activate  # Linux/macOS
# OR
venv\Scripts\activate     # Windows

# Install dependencies
pip install mcp>=1.9.4
```

#### Step 4: Configure Claude Desktop

**Find your configuration file:**
- **Linux:** `~/.config/claude/claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

**Add this configuration:**
```json
{
  "mcpServers": {
    "context-provider": {
      "command": "/home/user/mcp-context-provider/venv/bin/python",
      "args": ["/home/user/mcp-context-provider/server/context_provider_server.py"],
      "env": {
        "CONTEXT_CONFIG_DIR": "/home/user/mcp-context-provider/contexts",
        "AUTO_LOAD_CONTEXTS": "true"
      }
    }
  }
}
```

**Important:** Replace `/home/user/mcp-context-provider` with your actual installation path.

### Step 5: Verify Installation

**Run the verification script:**
```bash
cd ~/mcp-context-provider
python verify_install.py
```

**Expected output:**
```
✓ Python version: 3.11.5
✓ MCP package installed
✓ Contexts directory found
✓ Found 5 JSON files
✓ Server loads successfully (5 contexts)
=== Installation verified ===
```

### Step 6: Restart and Test

1. **Restart Claude Desktop** completely
2. **Start a new chat** in Claude Desktop
3. **Test the installation** by asking Claude:

```
Can you list available contexts using the MCP Context Provider?
```

**Expected response:** Claude should use the `list_available_contexts` tool and show:
- dokuwiki
- terraform  
- azure
- git
- general_preferences

## What You Get

Once installed, these tools are available in every Claude chat:

- **`list_available_contexts`** - See all loaded context categories
- **`get_context_rules`** - Get rules for specific tools (e.g., Terraform, Git)
- **`apply_auto_corrections`** - Auto-correct syntax (Markdown → DokuWiki)
- **`get_tool_preferences`** - Get your saved preferences for tools

## Example Usage

**Get Terraform naming rules:**
```
Get the context rules for terraform
```

**Auto-convert Markdown to DokuWiki:**
```
Apply auto-corrections to this markdown for dokuwiki:
# My Header
This is `code` and a [link](http://example.com)
```

**Check what contexts are available:**
```
List all available contexts
```

## Troubleshooting

### Installation Issues

**Problem:** `dxt: command not found`
```bash
# Install Node.js first, then:
npm install -g @anthropic-ai/dxt
```

**Problem:** `ModuleNotFoundError: No module named 'mcp'`
```bash
# Activate venv and install:
source venv/bin/activate
pip install mcp>=1.9.4
```

**Problem:** Context Provider not showing in Claude
1. Check Claude Desktop config file syntax with: `python -m json.tool claude_desktop_config.json`
2. Verify all file paths in config are absolute and correct
3. Restart Claude Desktop completely

### Quick Diagnostic

Run this to check your setup:
```bash
# Test server manually
cd ~/mcp-context-provider
source venv/bin/activate
python server/context_provider_server.py
# Should start without errors
```

### Reset Installation

If something goes wrong:
```bash
# Remove installation
rm -rf ~/mcp-context-provider

# Remove from Claude config
# Edit your Claude Desktop config file:
# - Linux: ~/.config/claude/claude_desktop_config.json
# - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# - Windows: %APPDATA%\Claude\claude_desktop_config.json
# Remove the "context-provider" section

# Start over with fresh install
```

## Advanced Configuration

### Custom Context Location

Set a different context directory:
```json
{
  "env": {
    "CONTEXT_CONFIG_DIR": "/path/to/my/custom/contexts"
  }
}
```

### Debug Mode

Enable detailed logging:
```json
{
  "env": {
    "DEBUG_MODE": "true"
  }
}
```

### Multiple Environments

Use different contexts for different projects:
```json
{
  "mcpServers": {
    "context-provider-work": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/server/context_provider_server.py"],
      "env": {
        "CONTEXT_CONFIG_DIR": "/work/contexts"
      }
    },
    "context-provider-personal": {
      "command": "/path/to/venv/bin/python", 
      "args": ["/path/to/server/context_provider_server.py"],
      "env": {
        "CONTEXT_CONFIG_DIR": "/personal/contexts"
      }
    }
  }
}
```

## Next Steps

1. **Explore the context files** in the `contexts/` directory
2. **Customize existing contexts** or create new ones
3. **Read the [Context Guide](CONTEXT_GUIDE.md)** for advanced usage
4. **Check [Examples](EXAMPLES.md)** for real-world scenarios

## Getting Help

- **Installation issues:** Check [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
- **Context customization:** Read [DEVELOPER_GUIDE.md](DEVELOPER_GUIDE.md)  
- **Bug reports:** Open an issue on [GitHub](https://github.com/doobidoo/MCP-Context-Provider/issues)

---

**That's it!** Your Claude Desktop now has persistent context that survives across all chat sessions. No more re-explaining your preferences every time you start a new conversation.