floci-mcp

MCP-сервер, который позволяет ИИ-агенту разворачивать и управлять ресурсами в стиле AWS на локальном экземпляре Floci — «запустить EC2-инстанс с такими параметрами», «создать корзину S3 и таблицу DynamoDB» и так далее.

Что он делает

Floci эмулирует 76 сервисов AWS на http://localhost:4566. floci-mcp предоставляет эту конечную точку любому MCP-совместимому клиенту в виде трёх инструментов:

• aws_call(service, action, params) — вызов любой операции AWS API (любой сервис, любое действие) против Floci. Это основной инструмент: поскольку он является тонким проходом к AWS API, он покрывает все 76 сервисов без создания отдельного инструмента для каждой операции.

• floci_status() — проверка доступности Floci.

• floci_inventory() — сводка того, что в данный момент развёрнуто в S3, DynamoDB, Lambda, EC2, SQS, SNS, ECS и RDS одним вызовом.

Related MCP server: AWS MCP Server

Предварительные требования

• Python 3.10+

• Запущенный экземпляр Floci — см. README Floci для floci start или настройки Docker.

Установка

Из клона (ещё не опубликовано на PyPI):

git clone https://github.com/Awilliv/floci-mcp.git
cd floci-mcp
pip install -e .

После публикации на PyPI:

pip install floci-mcp

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

Переменные окружения, все необязательные:

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

После регистрации в MCP-клиенте можно просить агента о таких вещах, как:

«Запустите EC2-инстанс с типом t3.micro, используя ami-00000000»

«Создайте корзину S3 с именем reports и таблицу DynamoDB с именем users с ключом раздела id»

Агент выполняет это через aws_call — он уже знает формы параметров AWS API, поэтому для работы не требуется отдельный инструмент для каждого сервиса.

Регистрация в MCP-клиенте

Claude Code

Явное указание AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY здесь (а не полагаясь на окружение запускающей оболочки) позволяет избежать случайной подписи запросов реальными учётными данными AWS, если они экспортированы где-то ещё.

claude mcp add floci -- floci-mcp

Или добавьте в .mcp.json:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "floci": {
      "command": "floci-mcp",
      "env": {
        "FLOCI_ENDPOINT_URL": "http://localhost:4566",
        "AWS_ACCESS_KEY_ID": "test",
        "AWS_SECRET_ACCESS_KEY": "test"
      }
    }
  }
}

Open WebUI (через mcpo)

Open WebUI говорит на OpenAPI/вызове инструментов, а не на MCP напрямую. Поместите floci-mcp за mcpo, чтобы предоставить его как OpenAPI-сервер:

pip install mcpo
mcpo --port 8000 -- floci-mcp

Затем в Open WebUI перейдите в Settings → Tools → Add a Tool Server и добавьте http://localhost:8000. mcpo передаёт переменные окружения запускаемому им процессу floci-mcp, поэтому установите FLOCI_ENDPOINT_URL и т.д. в оболочке, из которой вы запускаете mcpo, перед его стартом.

Разработка

pip install -e ".[test]"
pytest

Интеграционные тесты в tests/test_integration.py требуют запущенного экземпляра Floci и автоматически пропускаются, если он недоступен.

Лицензия

MIT