docs-rag/MCP_CLIENTS.md

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:

{
  "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):

{
  "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:

{
  "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:

{
  "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:

{
  "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

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

Windsurf Configuration

Add to your Windsurf MCP configuration:

{
  "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