🤖 Criage MCP Server

Обзор

Criage MCP Server предоставляет полный функционал пакетного менеджера через протокол MCP (Model Context Protocol) для интеграции с AI инструментами.

Что такое MCP Server?

MCP Server позволяет AI ассистентам напрямую взаимодействовать с Criage для:

• 🔍 Поиска и установки пакетов - AI может искать подходящие пакеты и устанавливать их
• 📦 Управления зависимостями - автоматическое решение конфликтов и обновлений
• 🆕 Создания новых пакетов - генерация структуры и настройка манифестов
• 🔨 Сборки и публикации пакетов - автоматизация процесса выпуска
• 📊 Получения информации - анализ состояния пакетов и репозиториев

Преимущества интеграции с AI

Установка

Требования

• Go 1.21 или выше
• Установленный Criage
• Claude Desktop или другой MCP клиент

Сборка сервера

# Перейти в директорию mcp-server
cd mcp-server

# Установить зависимости
go mod tidy

# Собрать сервер
go build -o criage-mcp-server.exe .

Интеграция с Claude Desktop

Настройка конфигурации

Добавьте MCP Server в конфигурацию Claude Desktop:

Windows

Отредактируйте файл %APPDATA%\Claude\config.json:

{
  "mcpServers": {
    "criage": {
      "command": "C:\\путь\\к\\criage-mcp-server.exe",
      "args": [],
      "env": {}
    }
  }
}

Linux/macOS

Отредактируйте файл ~/.config/claude-desktop/config.json:

{
  "mcpServers": {
    "criage": {
      "command": "/path/to/criage-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Проверка интеграции

1. Перезапустите Claude Desktop
2. В новом чате должны появиться инструменты Criage
3. Попробуйте запрос: "Покажи список доступных инструментов Criage"

Доступные инструменты

Параметры инструментов

Каждый инструмент принимает различные параметры для точной настройки операций:

install_package

{
  "name": "package-name",        // Обязательно: имя пакета
  "version": "1.2.3",           // Необязательно: конкретная версия
  "global": false,              // Необязательно: глобальная установка
  "force": false,               // Необязательно: принудительная переустановка
  "arch": "amd64",             // Необязательно: целевая архитектура
  "os": "windows"              // Необязательно: целевая ОС
}

search_packages

{
  "query": "web framework",     // Обязательно: поисковый запрос
  "limit": 10,                 // Необязательно: максимум результатов
  "category": "web"            // Необязательно: фильтр по категории
}

Примеры использования

Поиск и установка пакета

Создание нового проекта

Управление зависимостями

Анализ репозитория

Конфигурация

Автоматическая конфигурация

MCP Server использует стандартную конфигурацию Criage из ~/.criage/config.json. При первом запуске автоматически создается конфигурация по умолчанию:

{
  "repositories": [
    {
      "name": "default",
      "url": "http://localhost:8080", 
      "priority": 1,
      "enabled": true
    }
  ],
  "global_path": "~/.criage/packages",
  "local_path": "./criage_modules",
  "cache_path": "~/.criage/cache",
  "temp_path": "~/.criage/temp",
  "timeout": 30,
  "max_concurrency": 4,
  "compression_level": 3,
  "force_https": false
}

Переменные окружения

Для настройки поведения сервера можно использовать переменные окружения:

# Включить подробное логирование
set CRIAGE_DEBUG=1

# Переопределить путь к конфигурации
set CRIAGE_CONFIG_PATH=C:\custom\config.json

# Отключить цвета в выводе
set NO_COLOR=1

Настройка репозиториев

Если вы используете собственный репозиторий Criage, обновите конфигурацию:

{
  "repositories": [
    {
      "name": "production",
      "url": "https://packages.mycompany.com",
      "priority": 10,
      "enabled": true,
      "token": "your-access-token"
    },
    {
      "name": "development", 
      "url": "https://dev-packages.mycompany.com",
      "priority": 5,
      "enabled": true
    }
  ]
}

Устранение проблем

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

Решения:

1. Убедитесь, что Go установлен корректно: go version
2. Проверьте права доступа к исполняемому файлу
3. Убедитесь, что директория ~/.criage доступна для записи
4. Проверьте правильность пути в конфигурации Claude Desktop

Инструменты не отображаются в Claude

Решения:

1. Проверьте синтаксис JSON в config.json
2. Перезапустите Claude Desktop
3. Убедитесь, что путь к серверу указан правильно
4. Проверьте логи Claude Desktop на наличие ошибок

Ошибки при работе с пакетами

Решения:

1. Проверьте доступность репозитория Criage
2. Убедитесь в правильности конфигурации репозитория
3. Проверьте права доступа к директориям установки
4. Включите отладочный режим: set CRIAGE_DEBUG=1

Отладка и логирование

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

# Windows
set CRIAGE_DEBUG=1
criage-mcp-server.exe

# Linux/macOS  
export CRIAGE_DEBUG=1
./criage-mcp-server

Проверка совместимости

Убедитесь в совместимости версий:

• ✅ Windows 10/11 - полная поддержка
• ✅ Ubuntu 20.04+ - полная поддержка
• ✅ macOS 10.15+ - полная поддержка
• ✅ Claude Desktop - основной клиент
• ⚠️ Другие MCP клиенты - базовая поддержка