sacloud/sacloud-mcp

Обзор

sacloud/sacloud-mcp — это MCP-сервер для Sakura Cloud.

Настройка среды разработки

Необходимые инструменты

Клонирование проекта

git clone https://github.com/sacloud/sacloud-mcp.git

Установка uv

Для получения более подробной информации об установке и использовании обратитесь к документации uv.

curl -LsSf https://astral.sh/uv/install.sh | sh

Синхронизация среды

uv sync

Установка MCP в LLM

Установите MCP в выбранную LLM. Ниже приведен пример настройки для Claude Desktop.

Добавьте следующее в файл конфигурации Claude Desktop. Обратите внимание, что расположение файла конфигурации зависит от ОС:

• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sacloud": {
      "command": "${HOME}/.local/bin/uv",
      "args": [
        "--directory",
        "<<MCPサーバーのルートディレクトリ>>/src",
        "run",
        "main.py"
      ],
      "env": {
        "<<環境変数1>>": "<<値をコピーしてここへ貼り付ける>>",
        "<<環境変数2>>": "<<値をコピーしてここへ貼り付ける>>"
      }
    }
  }
}

Замените элементы, указанные в <<>>, в соответствии с приведенными ниже инструкциями:

• Корневой каталог MCP-сервера

  • Пример: /Users/user/Source/sacloud-mcp

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

  • Установите переменные окружения в зависимости от используемых функций.

    • При доступе к ресурсам Sakura Cloud обратитесь к API-ключу Sakura Cloud и замените значения.

      • "ACCESS_TOKEN": "<<скопируйте значение и вставьте сюда>>"

      • "ACCESS_TOKEN_SECRET": "<<скопируйте значение и вставьте сюда>>"

    • При доступе к объектному хранилищу Sakura обратитесь к API-ключу объектного хранилища Sakura и замените значения.

      • "OBJECTSTORAGE_ACCESS_KEY_ID": "<<скопируйте значение и вставьте сюда>>"

      • "OBJECTSTORAGE_SECRET_ACCESS_KEY": "<<скопируйте значение и вставьте сюда>>"

Тестирование

О конфигурации

В файле tests/conftest.py определены фикстуры, доступные для всех тестовых файлов, и их можно использовать во всех тестах без явного import.

Подготовка

Поскольку учетные данные извлекаются из переменных окружения, перед запуском тестов необходимо установить ACCESS_TOKEN и ACCESS_TOKEN_SECRET.

export ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxx
export ACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
export OBJECTSTORAGE_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxx

Запуск тестов

uv run pytest

Лицензия

sacloud-mcp Copyright (C) 2025- Авторы sacloud/sacloud-mcp. Этот проект опубликован под лицензией Apache 2.0.