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

MCP_CLIENTS.md 3.1 KB Istoric Crud