yandex-cloude-mcp

Неофициальный mcp сервер для взаимодействия с Yandex Cloude API.

Функциональность:

📋 Список всех bucket в вашем аккаунте 📁 Просмотр содержимого конкретного bucket ⬇️ Скачивание файлов в локальную папку

Технические детали:

Использует официальный AWS SDK (совместим с Yandex Cloud) Настроен endpoint для Yandex Cloud(https://storage.yandexcloud.net) Поддерживает все основные операции через MCP протокол

Безопасность:

Ключи доступа хранятся в переменных окружения Можно настроить права доступа через сервисные аккаунты

¡После создания и настройки этого сервера, Claude сможет подключиться к вашим cubo в Yandex Cloud и помочь с анализом данных, управлением файлами и другими задачами!

Шаг 1: Создание проекта

Выполните команды в терминале:

mkdir yandex-cloud-mcp cd yandex-cloud-mcp npm init -y

Шаг 2: Установка зависимостей

Основные зависимости

npm install @modelcontextprotocol/sdk @aws-sdk/client-s3 dotenv Dev зависимости для TypeScript npm install -D typescript @types/node ts-node nodemon

Шаг 3: Создание структуры папок

mkdir src

Шаг 4: Конфигурационные файлы Создайт

Создайте файл tsconfig.json в корне проекта:

{ "compilerOptions": { "target": "ES2020", "module": "commonjs", "outDir": "./dist", "rootDir": "./src", "strict": true, "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "resolveJsonModule": true }, "include": ["src/**/*"], "exclude": ["node_modules", "dist"] }

Обновите package.json, добавив scripts:

{ "scripts": { "build": "tsc", "start": "node dist/index.js", "dev": "ts-node src/index.ts", "watch": "nodemon --exec ts-node src/index.ts" } }

Шаг 5: Файл переменных окружения Создайте файл .env в корне проекта:

YANDEX_ACCESS_KEY_ID=su_yandex_access_key_id_aquí YANDEX_SECRET_ACCESS_KEY=su_yandex_secret_access_key_aquí

⚠️ Пока оставьте placeholder значения - мы заполним их после получения ключей Шаг 6: Основной код Создайте файл src/index.ts и скопируйте туда весь код из артефакта (он так же называется index.ts) выше (начиная с #!/usr/bin/env node).

Шаг 7: Получение ключей доступа в Yandex Cloud

Перейдите в консоль Yandex Cloud : https://console.cloud.yandex.ru/ Войдитев аккаунт или создайте новый, если его нет Создайте или выберите каталог (carpeta) в вашем облаке Перейдите в IAM:

В левом меню найдите "Identity and Access Management" или "IAM" Выберите "Сервисные аккаунты"

Создайте сервисный аккаунт:

Нажмите "Создать сервисный аккаунт" Введите имя (например, "mcp-s3-access") Назначьте роль storage.editor (для полного доступа) или storage.viewer (только чтение) Нажмите "Создать"

Создайте статический ключ доступа:

Откройте созданный сервисный аккаунт Перейдите на вкладку "Ключи доступа" Нажмите "Создать новый ¡ключ" → "Статический ключ доступа" Сохраните Clave de acceso ID и Clave de acceso secreta (они показываются только один раз!)

Шаг 8: Обновление .env файла Откройте файл .env и замените placeholder значения на ваши ключи:

YANDEX_ACCESS_KEY_ID=YCAJEваш_access_key_id_здесь YANDEX_SECRET_ACCESS_KEY=YCваш_очень_длинный_secret_key_здесь

Шаг 9: Тестирование Попробуйте запустить сервер: bashnpm run build npm start Если все настроено правильно, должно появиться сообщение: Yandex Cloud MCP сервер запущен

Шаг 10: Подключение к Claude Desktop

1. Найдите файл конфигурации Claude Desktop Файл конфигурации находится в разных местах в зависимости от ОС:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

3. Создайте или отредактируйте конфигурацию Если файл не существует - создайте его. Если существует - добавьте ваш сервер. Новый файл конфигурации:

{ "mcpServers": { "yandex-cloud": { "command": "node", "args": ["/полный/путь/к/вашему/проекту/yandex-cloud-mcp/dist/index.js"], "env": {"YANDEX_ACCESS_KEY_ID": "ваш_access_key_id", "YANDEX_SECRET_ACCESS_KEY": "ваш_secret_access_key" } } }

Если файл уже существует, добавьте в секцию mcpServers:

{ "mcpServers": { "существующие-серверы": { ... }, "yandex-cloud": { "command": "node", "args": ["/полный/путь/к/вашему/проекту/yandex-cloud-mcp/dist/index.js"], "env": {"YANDEX_ACCESS_KEY_ID": "ваш_access_key_id", "YANDEX_SECRET_ACCESS_KEY": "ваш_secret_access_key" } } }

5. Узнайте полный путь к проекту В терминале, находясь в папке yandex-cloud-mcp:

Windows: cmdecho %cd%\dist\index.js macOS/Linux: bashecho "$(pwd)/dist/index.js"

7. Перезапустите Claude Desktop Полностью закройте и снова откройте приложение Claude Desktop.
8. Проверьте подключение После перезапуска попробуйте написать в чате: Можешь показать мои bucket в Yandex Cloud? Если все настроено правильно, Claude сможет использовать инструменты для работы с вашим Yandex Cloud! Важно: Замените /полный/путь/к/вашему/проекту/ на реальный путь к вашей папке проекта.

Пояснения по шагам:

Шаг 4:

Создание tsconfig.json

Откройте текстовый редактор (например, VS Code, Notepad++, или любой другой) Создайте новый файл в корневой папке yandex-cloud-mcp (там же где package.json) Назовите файл tsconfig.json (важно: именно это имя, с расширением .json) Скопируйте и вставьте этот код:

{ "compilerOptions": { "target": "ES2020", "module": "commonjs", "outDir": "./dist", "rootDir": "./src", "strict": true, "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "resolveJsonModule": true }, "include": ["src/**/*"], "exclude": ["node_modules", "dist"] }

Сохраните файл

Обновление package.json

Откройте файл package.json (он уже существует после npm init -y) Найдите секцию "scripts" (она может выглядеть примерно так):

"scripts": {"test": "echo \"Error: no test specified\" && exit 1" }

Замените её на:

"scripts": { "build": "tsc", "start": "node dist/index.js", "dev": "ts-node src/index.ts", "watch": "nodemon --exec ts-node src/index.ts", "test": "echo \"Error: no test specified\" && exit 1" }

Сохраните файл

Альтернативный способ (через терминал) Если предпочитаете командную строку:

Создание tsconfig.json

cat > tsconfig.json << 'EOF' { "compilerOptions": { "target": "ES2020", "module": "commonjs", "outDir": "./dist", "rootDir": "./src", "strict": true, "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "resolveJsonModule": true }, "include": ["src/**/*"], "exclude": ["node_modules", "dist"] } EOF

Проверка После выполнения у вас должна быть такая структура:

yandex-cloud-mcp/ ├── node_modules/ ├── src/ ├── package.json ├── package-lock.json └── tsconfig.json