Развёртывание на Windows

Специфика установки и настройки MCP серверов на Windows

Развёртывание MCP серверов на Windows имеет ряд важных отличий от macOS и Linux. Эта документация поможет избежать типичных ошибок.

Ключевые отличия

Аспект	macOS/Linux	Windows
Пути	`/path/to/server`	`C:\\path\\to\\server`
Команды	`npx`, `uvx`	Полный путь к `node.exe`
Слэши	`/`	`\\` (двойные в JSON)
Переменные	`$HOME`	`%USERPROFILE%`

Установка зависимостей

Node.js

Скачайте LTS версию с nodejs.org
Установите с опцией “Add to PATH”
Проверьте установку:

node --version
npm --version

Python

Скачайте с python.org
Важно: Отметьте “Add Python to PATH”
Проверьте:

python --version
pip --version

uv (рекомендуется для Python)

# Через pip
pip install uv

# Или через PowerShell
irm https://astral.sh/uv/install.ps1 | iex

Claude Desktop конфигурация

Файл конфигурации находится:

%APPDATA%\Claude\claude_desktop_config.json

Или полный путь:

C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json

Правильный формат

{
  "mcpServers": {
    "my-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\username\\mcp-servers\\my-server\\dist\\index.js"]
    }
  }
}

Типичные ошибки

❌ Неправильно:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@myorg/mcp-server"]
    }
  }
}

✅ Правильно:

{
  "mcpServers": {
    "my-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\username\\AppData\\Roaming\\npm\\node_modules\\@myorg\\mcp-server\\dist\\index.js"
      ]
    }
  }
}

Пути на Windows

Нахождение путей

# Путь к node.exe
where node

# Путь к npm packages
npm root -g

# Путь к Python
where python

# Путь к pip packages
pip show mcp

Примеры путей

Программа	Типичный путь
node.exe	`C:\Program Files\nodejs\node.exe`
npm modules	`C:\Users\<user>\AppData\Roaming\npm\node_modules`
python.exe	`C:\Users\<user>\AppData\Local\Programs\Python\Python312\python.exe`
pip packages	`C:\Users\<user>\AppData\Local\Programs\Python\Python312\Lib\site-packages`

Конфигурация для Python

С обычным Python

{
  "mcpServers": {
    "python-server": {
      "command": "C:\\Users\\username\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": [
        "-m",
        "src.server"
      ],
      "cwd": "C:\\Users\\username\\mcp-servers\\my-server"
    }
  }
}

С uv

{
  "mcpServers": {
    "uv-server": {
      "command": "C:\\Users\\username\\.local\\bin\\uv.exe",
      "args": [
        "run",
        "python",
        "-m",
        "src.server"
      ],
      "cwd": "C:\\Users\\username\\mcp-servers\\my-server"
    }
  }
}

С виртуальным окружением

{
  "mcpServers": {
    "venv-server": {
      "command": "C:\\Users\\username\\mcp-servers\\my-server\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "src.server"
      ],
      "cwd": "C:\\Users\\username\\mcp-servers\\my-server"
    }
  }
}

Конфигурация для Node.js

Локальный проект

{
  "mcpServers": {
    "node-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\username\\mcp-servers\\my-server\\dist\\index.js"
      ]
    }
  }
}

Глобально установленный пакет

{
  "mcpServers": {
    "global-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\username\\AppData\\Roaming\\npm\\node_modules\\@myorg\\mcp-server\\dist\\index.js"
      ]
    }
  }
}

PowerShell скрипты

Wrapper скрипт

Создайте run-mcp.ps1:

#!/usr/bin/env pwsh

$ErrorActionPreference = "Stop"

# Путь к проекту
$projectPath = "C:\Users\username\mcp-servers\my-server"

# Активация venv
& "$projectPath\.venv\Scripts\Activate.ps1"

# Запуск сервера
python -m src.server

Использование в конфигурации

{
  "mcpServers": {
    "ps-server": {
      "command": "powershell.exe",
      "args": [
        "-ExecutionPolicy", "Bypass",
        "-File", "C:\\Users\\username\\mcp-servers\\run-mcp.ps1"
      ]
    }
  }
}

Environment Variables

{
  "mcpServers": {
    "my-server": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\path\\to\\server.js"],
      "env": {
        "DATABASE_URL": "postgresql://localhost/mydb",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Troubleshooting

Проверка работоспособности

# Тест Node.js сервера
& "C:\Program Files\nodejs\node.exe" "C:\path\to\server\dist\index.js"

# Тест Python сервера
& "C:\path\to\.venv\Scripts\python.exe" -m src.server

Логирование

Для отладки включите логирование:

{
  "mcpServers": {
    "my-server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "DEBUG": "mcp:*",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Типичные проблемы

Сервер не запускается

Проверьте пути — используйте полные абсолютные пути
Проверьте двойные слэши в JSON
Убедитесь, что все зависимости установлены

Permission denied

# Проверка прав на выполнение
Get-ExecutionPolicy

# Разрешение выполнения скриптов
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Модуль не найден

# Проверка установки npm пакета
npm list -g @myorg/mcp-server

# Переустановка
npm install -g @myorg/mcp-server

WSL (Windows Subsystem for Linux)

Альтернативный подход — использование WSL:

{
  "mcpServers": {
    "wsl-server": {
      "command": "wsl.exe",
      "args": [
        "--",
        "python3",
        "-m",
        "src.server"
      ],
      "cwd": "\\\\wsl$\\Ubuntu\\home\\user\\mcp-servers\\my-server"
    }
  }
}