Начиная с версии 0.3.17 (b10), LM Studio поддерживает как локальные, так и удалённые серверы MCP. Вы можете добавить серверы MCP, отредактировав файл mcp.json в приложении или нажав кнопку "Добавить в LM Studio" (Add to LM Studio), если она доступна. В настоящее время LM Studio использует нотацию mcp.json от Cursor.

Будьте осторожны

MCP-серверы могут выполнять произвольный код на вашем компьютере. Добавляйте только те MCP-серверы, которым вы доверяете.

Установка новых серверов: mcp.json

Чтобы добавить новый MCP-сервер, отредактируйте файл mcp.json в директории конфигурации LM Studio или используйте встроенный редактор в приложении.

Путь к файлу mcp.json

Mac / Linux:

~/.lmstudio/mcp.json

Windows:

%USERPROFILE%\.lmstudio\mcp.json

Формат конфигурации

Файл mcp.json использует следующий формат:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-name"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Пример конфигурации

Вот пример конфигурации для нескольких популярных MCP-серверов:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/db"
      }
    }
  }
}

Кнопка "Добавить в LM Studio"

Некоторые MCP-серверы предоставляют кнопку "Добавить в LM Studio" (Add to LM Studio) для упрощения установки. Эта кнопка автоматически добавляет конфигурацию сервера в ваш файл mcp.json.

Если вы разрабатываете MCP-сервер, вы можете добавить эту кнопку на свою страницу документации или в README. Подробности смотрите в разделе Кнопка "Добавить в LM Studio".

Пример для тестирования: Hugging Face MCP Server

Вы можете попробовать MCP-сервер от Hugging Face для поиска и загрузки моделей:

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

Этот сервер позволяет вашей модели:

• Искать модели на Hugging Face
• Получать информацию о моделях
• Загружать файлы моделей

Использование MCP-серверов в чате

После добавления MCP-серверов в файл mcp.json, они автоматически становятся доступны в интерфейсе чата (Chat). Вы можете:

• Включать и отключать MCP-серверы для каждого чата
• Видеть доступные инструменты (Tools) от подключённых серверов
• Использовать эти инструменты в разговоре с моделью

Подробнее об использовании MCP-серверов в чате читайте в разделе Управление чатами.

Поддерживаемые типы MCP-серверов

Локальные серверы (Local Servers)

Запускаются на вашем компьютере через команду (command) с аргументами. Обычно используют npx для запуска Node.js пакетов.

Удалённые серверы (Remote Servers)

Подключаются к удалённому серверу через URL. Используйте формат:

{
  "mcpServers": {
    "remote-server": {
      "url": "https://example.com/mcp"
    }
  }
}

Проблемы и устранение неполадок

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

• Убедитесь, что у вас установлен Node.js и npm
• Проверьте правильность пути к команде
• Проверьте логи LM Studio для получения подробной информации об ошибке

Модель не использует инструменты MCP

• Убедитесь, что модель поддерживает вызовы функций (function calling)
• Проверьте, что MCP-сервер успешно подключён в интерфейсе чата (Chat)
• Попробуйте перезапустить LM Studio

Ошибки доступа к файлам

• Проверьте права доступа к директориям
• Убедитесь, что пути указаны правильно
• Для Windows используйте двойные обратные слэши или прямые слэши

Проблемы с переменными окружения

• Убедитесь, что все необходимые переменные окружения указаны в секции env
• Проверьте правильность API-ключей и токенов
• Не храните чувствительные данные в файле mcp.json, если он находится в публичном доступе

---

---

Оригинал страницы