Kube Core MCP

Служба обработки команд Kubernetes, преобразующая запросы на естественном языке в допустимые команды kubectl.

Функции

• Преобразование естественного языка в команды kubectl

• Проверка правильности команд и проверка безопасности

• Поддержка общих операций kubectl

• Интеграция AWS Bedrock для обработки LLM

Related MCP server: MCP Remote Server for Kubernetes

Предпосылки

• Питон 3.8+

• Настроены учетные данные AWS

• kubectl установлен и настроен

• Node.js и npm (для фронтенда)

Настраивать

1. Клонируйте репозиторий:

git clone <repository-url>
cd kube-core-mcp

2. Создайте и активируйте виртуальную среду:

python3 -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\activate

3. Установить зависимости:

pip install -r requirements.txt

4. Настройте учетные данные AWS:

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region

5. Запустите сервер FastAPI:

python src/server.py

API-документация

Проверка здоровья

curl http://localhost:3000/health

Услуги

curl http://localhost:3000/api/services

Команды естественного языка

curl -X POST http://localhost:3000/api/nl \
  -H "Content-Type: application/json" \
  -d '{"message": "show me the pods in default namespace"}'

Прямые команды

curl -X POST http://localhost:3000/api/command \
  -H "Content-Type: application/json" \
  -d '{"command": "kubectl get pods -n default"}'

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

Сервис работает в двух режимах безопасности:

1. СТРОГИЙ (по умолчанию):

   • Разрешает только предопределенные шаблоны команд

   • Проверяет все команды на соответствие разрешенным шаблонам

   • Предотвращает опасные операции

2. РАЗРЕШИТЕЛЬНЫЙ:

   • Позволяет использовать более гибкие шаблоны команд

   • По-прежнему поддерживает базовые проверки безопасности

   • Полезно для разработки и тестирования

Разработка

Проведение тестов

pytest tests/

Стиль кода

black src/ tests/
flake8 src/ tests/

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Внесите изменения

4. Проведение тестов

5. Отправить запрос на извлечение

Лицензия

[Добавить информацию о лицензии]