# MCP Client Configuration Examples

This directory contains configuration examples for integrating the Docs RAG MCP server with various MCP clients.

## Quick Configuration (JSON Example)

For most MCP clients, use this simple JSON configuration:

```json
{
  "mcpServers": {
    "docs-rag": {
      "command": "npx",
      "args": ["-y", "docs-rag-mcp"],
      "cwd": "/path/to/docs-rag"
    }
  }
}
```

⚠️ **Important:**
- Use `"mcpServers":` (plural), **not** `"mcp":`
- Don't include `"type": "stdio"` (not needed for this implementation)
- Replace `/path/to/docs-rag` with absolute path to your docs-rag project
- Ensure project has been built (`npm run build`)

**Optional (add to env section if needed):**
```json
{
  "mcpServers": {
    "docs-rag": {
      "command": "npx",
      "args": ["-y", "docs-rag-mcp"],
      "cwd": "/path/to/docs-rag",
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "OLLAMA_URL": "http://localhost:11434",
        "OLLAMA_EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}
```

---

## Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "docs-rag": {
      "command": "npx",
      "args": ["-y", "docs-rag-mcp"],
      "cwd": "/path/to/docs-rag",
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "OLLAMA_URL": "http://localhost:11434",
        "OLLAMA_EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}
```

## VS Code Configuration

Add to your VS Code `settings.json`:

```json
{
  "mcp": {
    "servers": {
      "docs-rag": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "docs-rag-mcp", "--transport", "stdio"],
        "cwd": "/path/to/docs-rag",
        "env": {
          "QDRANT_URL": "http://localhost:6333",
          "OLLAMA_URL": "http://localhost:11434",
          "OLLAMA_EMBEDDING_MODEL": "nomic-embed-text"
        }
      }
    }
  }
}
```

## Cursor Configuration

Add to your `mcp.json`:

```json
{
  "mcpServers": {
    "docs-rag": {
      "command": "npx",
      "args": ["-y", "docs-rag-mcp"],
      "cwd": "/path/to/docs-rag",
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "OLLAMA_URL": "http://localhost:11434",
        "OLLAMA_EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}
```

## Claude Code CLI

```bash
claude mcp add docs-rag -- npx -y docs-rag-mcp --cwd /path/to/docs-rag
```

## Windsurf Configuration

Add to your Windsurf MCP configuration:

```json
{
  "mcpServers": {
    "docs-rag": {
      "command": "npx",
      "args": ["-y", "docs-rag-mcp"],
      "cwd": "/path/to/docs-rag",
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "OLLAMA_URL": "http://localhost:11434",
        "OLLAMA_EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}
```

## Notes

- Replace `/path/to/docs-rag` with the actual absolute path to your docs-rag project
- Ensure Qdrant and Ollama services are running before using the MCP server
- The MCP server automatically loads environment variables from the `.env` file in the project directory
- Make sure the project is built (`npm run build`) or that `tsx` is available for development mode