WINDOWS_SETUP.md

Windows 11 Setup for Qdrant MCP Server

Prerequisites

• Node.js 20.x or later (LTS recommended)
• npm 10.x or later
• Qdrant or Chroma vector database
• PowerShell 7+ recommended (Windows PowerShell 5.1 will also work)

Installation Steps

1. Clone the repository:

git clone <repository-url>
cd qdrant-mcp-server

2. Install dependencies:

npm install

3. Create a .env file in the root directory:

Copy-Item .env.example .env

4. Update the .env file with your settings using Notepad or any text editor:

DATABASE_TYPE=qdrant
QDRANT_URL=https://your-qdrant-instance.example.com:6333
QDRANT_API_KEY=your_api_key
COLLECTION_NAME=your_collection_name

5. Build the project using the Windows-specific build command:

npm run build:windows

AI IDE Integration

Cursor AI IDE

1. Make sure the run-cursor-mcp.ps1 script is in your project root directory.

2. Create the .cursor directory in your project root if it doesn't exist:

mkdir -Force .cursor

3. Create or edit the .cursor/mcp.json file with this configuration:

{
  "mcpServers": {
    "qdrant-retrieval": {
      "command": "powershell.exe",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "C:\\Users\\ASUS\\vito-mcp\\run-cursor-mcp.ps1"],
      "env": {
        "DATABASE_TYPE": "qdrant",
        "COLLECTION_NAME": "vito",
        "HTTP_SERVER": "true",
        "HTTP_PORT": "3000",
        "QDRANT_URL": "https://your-qdrant-instance.example.com:6333",
        "QDRANT_API_KEY": "your_api_key"
      },
      "url": "http://localhost:3000"
    }
  }
}

Important Windows Configuration Notes:

1. Include environment variables directly in the MCP configuration's env section.
2. Use HTTP server mode instead of stdio (HTTP_SERVER: "true") as Windows has issues with stdio-based MCP servers.
3. Specify an HTTP port and add the corresponding url field to the configuration.

4. If you need to allow PowerShell script execution, run this command as Administrator:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Claude Desktop

1. In Claude Desktop settings, add this configuration (replace the path with your actual project path):

{
  "processes": {
    "knowledge_server": {
      "command": "powershell.exe",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "C:\\path\\to\\your\\project\\run-cursor-mcp.ps1"]
    }
  },
  "tools": [
    {
      "name": "store_knowledge",
      "description": "Store domain-specific knowledge in a vector database",
      "provider": "process",
      "process": "knowledge_server"
    },
    {
      "name": "retrieve_knowledge_context",
      "description": "Retrieve relevant domain knowledge from a vector database",
      "provider": "process",
      "process": "knowledge_server"
    }
  ]
}

Usage

Starting the Server

npm start

For development with auto-reload:

npm run dev

Storing Documentation

npm run store-doc docs/manual.pdf
# or
npm run store-doc docs/readme.txt

Troubleshooting

1. PowerShell Execution Policy: If you get an execution policy error, run:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. Path Issues: Ensure all paths use Windows-style backslashes (\\) and full paths where needed.

3. Node Version: Verify your Node.js version with:

node --version

4. Connection Issues: Check your firewall settings if you're having trouble connecting to Qdrant.