feat: add SUMMARY.md for ollama-mcp project overview
This commit is contained in:
Claude AI
320
apps/ollama-mcp/SUMMARY.md
Normal file
320
apps/ollama-mcp/SUMMARY.md
Normal file
@@ -0,0 +1,320 @@
|
||||
# Ollama MCP Integration - Summary
|
||||
|
||||
## Что создано
|
||||
|
||||
Полное решение для интеграции Ollama с твоим Kubernetes кластером и Gitea через MCP серверы.
|
||||
|
||||
### Структура проекта
|
||||
|
||||
```
|
||||
apps/ollama-mcp/
|
||||
├── README.md # Полная документация
|
||||
├── QUICKSTART.md # Быстрый старт
|
||||
├── install.sh # Автоматическая установка
|
||||
├── docker-compose.yml # Docker Compose конфигурация
|
||||
├── .env.example # Пример переменных окружения
|
||||
├── .gitignore # Git ignore правила
|
||||
├── config/
|
||||
│ └── kubeconfig # Kubernetes конфигурация (создается при установке)
|
||||
├── mcp-kubernetes/
|
||||
│ ├── Dockerfile
|
||||
│ ├── package.json
|
||||
│ └── index.js # REST API для Kubernetes
|
||||
└── mcp-gitea/
|
||||
├── Dockerfile
|
||||
├── package.json
|
||||
└── index.js # REST API для Gitea
|
||||
```
|
||||
|
||||
## Установка на GPU сервере
|
||||
|
||||
### Вариант 1: Автоматическая установка (рекомендуется)
|
||||
|
||||
```bash
|
||||
curl -sSL https://git.thedevops.dev/admin/k3s-gitops/raw/branch/main/apps/ollama-mcp/install.sh | bash
|
||||
```
|
||||
|
||||
### Вариант 2: Ручная установка
|
||||
|
||||
```bash
|
||||
# 1. Клонировать репозиторий
|
||||
git clone https://git.thedevops.dev/admin/k3s-gitops.git
|
||||
cd k3s-gitops/apps/ollama-mcp
|
||||
|
||||
# 2. Настроить окружение
|
||||
cp .env.example .env
|
||||
nano .env # Добавить GITEA_TOKEN
|
||||
|
||||
# 3. Скопировать kubeconfig
|
||||
mkdir -p config
|
||||
cp ~/.kube/config config/kubeconfig
|
||||
|
||||
# 4. Запустить
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
## Что получаешь
|
||||
|
||||
### 1. MCP Kubernetes Server (порт 3001)
|
||||
|
||||
REST API для управления кластером:
|
||||
|
||||
**Доступные эндпоинты:**
|
||||
|
||||
- `POST /api/pods/list` - список подов
|
||||
```json
|
||||
{"namespace": "argocd"}
|
||||
```
|
||||
|
||||
- `POST /api/pods/logs` - логи пода
|
||||
```json
|
||||
{"name": "pod-name", "namespace": "argocd", "tailLines": 100}
|
||||
```
|
||||
|
||||
- `POST /api/deployments/list` - список деплойментов
|
||||
```json
|
||||
{"namespace": "default"}
|
||||
```
|
||||
|
||||
- `POST /api/deployments/get` - получить деплоймент
|
||||
```json
|
||||
{"name": "nginx", "namespace": "default"}
|
||||
```
|
||||
|
||||
- `POST /api/services/list` - список сервисов
|
||||
```json
|
||||
{"namespace": "default"}
|
||||
```
|
||||
|
||||
- `POST /api/namespaces/list` - список namespace
|
||||
```json
|
||||
{}
|
||||
```
|
||||
|
||||
### 2. MCP Gitea Server (порт 3002)
|
||||
|
||||
REST API для работы с Git:
|
||||
|
||||
**Доступные эндпоинты:**
|
||||
|
||||
- `POST /api/repos/list` - список репозиториев
|
||||
```json
|
||||
{"owner": "admin"}
|
||||
```
|
||||
|
||||
- `POST /api/repos/file/get` - содержимое файла
|
||||
```json
|
||||
{"owner": "admin", "repo": "k3s-gitops", "path": "apps/loki/statefulset.yaml", "branch": "main"}
|
||||
```
|
||||
|
||||
- `POST /api/repos/tree/get` - содержимое директории
|
||||
```json
|
||||
{"owner": "admin", "repo": "k3s-gitops", "path": "apps", "branch": "main"}
|
||||
```
|
||||
|
||||
- `POST /api/repos/file/create` - создать файл
|
||||
```json
|
||||
{
|
||||
"owner": "admin",
|
||||
"repo": "k3s-gitops",
|
||||
"path": "test.yaml",
|
||||
"content": "apiVersion: v1\nkind: Pod",
|
||||
"message": "Add test file",
|
||||
"branch": "main"
|
||||
}
|
||||
```
|
||||
|
||||
- `POST /api/repos/file/update` - обновить файл
|
||||
```json
|
||||
{
|
||||
"owner": "admin",
|
||||
"repo": "k3s-gitops",
|
||||
"path": "test.yaml",
|
||||
"content": "updated content",
|
||||
"message": "Update test file",
|
||||
"sha": "file-sha",
|
||||
"branch": "main"
|
||||
}
|
||||
```
|
||||
|
||||
- `POST /api/repos/branches/list` - список веток
|
||||
```json
|
||||
{"owner": "admin", "repo": "k3s-gitops"}
|
||||
```
|
||||
|
||||
## Интеграция с Ollama
|
||||
|
||||
### Способ 1: Прямые запросы через curl
|
||||
|
||||
Ollama может генерировать curl команды:
|
||||
|
||||
```bash
|
||||
ollama run qwen2.5-coder:32b "
|
||||
I have MCP servers running:
|
||||
- Kubernetes API: http://localhost:3001
|
||||
- Gitea API: http://localhost:3002
|
||||
|
||||
Generate curl command to list all pods in argocd namespace
|
||||
"
|
||||
```
|
||||
|
||||
### Способ 2: Custom Function/Tool
|
||||
|
||||
Создай промпт-шаблон для Ollama:
|
||||
|
||||
```bash
|
||||
cat > ~/ollama-k8s-prompt.txt << 'EOF'
|
||||
You are a Kubernetes and Git operations assistant. You have access to:
|
||||
|
||||
**Kubernetes MCP (http://localhost:3001):**
|
||||
- POST /api/pods/list {"namespace": "name"}
|
||||
- POST /api/pods/logs {"name": "pod", "namespace": "ns", "tailLines": 100}
|
||||
- POST /api/deployments/list {"namespace": "name"}
|
||||
- POST /api/services/list {"namespace": "name"}
|
||||
- POST /api/namespaces/list {}
|
||||
|
||||
**Gitea MCP (http://localhost:3002):**
|
||||
- POST /api/repos/list {"owner": "admin"}
|
||||
- POST /api/repos/file/get {"owner": "admin", "repo": "name", "path": "file.yaml"}
|
||||
- POST /api/repos/tree/get {"owner": "admin", "repo": "name", "path": "dir/"}
|
||||
- POST /api/repos/file/create {"owner": "admin", "repo": "name", "path": "file", "content": "...", "message": "..."}
|
||||
|
||||
When asked to perform operations:
|
||||
1. Generate the appropriate curl command
|
||||
2. Execute it if possible
|
||||
3. Interpret the results
|
||||
4. Provide clear explanations
|
||||
|
||||
Always use JSON format for request bodies.
|
||||
EOF
|
||||
```
|
||||
|
||||
Использование:
|
||||
```bash
|
||||
ollama run qwen2.5-coder:32b "$(cat ~/ollama-k8s-prompt.txt)
|
||||
|
||||
User request: Покажи все поды в namespace monitoring и их статус"
|
||||
```
|
||||
|
||||
### Способ 3: Wrapper Script
|
||||
|
||||
Создай `~/ollama-ops.sh`:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
|
||||
SYSTEM_PROMPT="You are a DevOps assistant with access to:
|
||||
- Kubernetes API at http://localhost:3001
|
||||
- Gitea API at http://localhost:3002
|
||||
Generate and execute curl commands to fulfill user requests."
|
||||
|
||||
ollama run qwen2.5-coder:32b "$SYSTEM_PROMPT
|
||||
|
||||
User: $*"
|
||||
```
|
||||
|
||||
Использование:
|
||||
```bash
|
||||
chmod +x ~/ollama-ops.sh
|
||||
./ollama-ops.sh "список подов в argocd"
|
||||
./ollama-ops.sh "покажи файл apps/loki/statefulset.yaml из k3s-gitops"
|
||||
```
|
||||
|
||||
## Примеры использования
|
||||
|
||||
### Kubernetes операции:
|
||||
|
||||
```bash
|
||||
# Список подов
|
||||
curl -X POST http://localhost:3001/api/pods/list \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"namespace": "argocd"}'
|
||||
|
||||
# Логи
|
||||
curl -X POST http://localhost:3001/api/pods/logs \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"name": "argocd-server-xxx", "namespace": "argocd", "tailLines": 50}'
|
||||
|
||||
# Deployments
|
||||
curl -X POST http://localhost:3001/api/deployments/list \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"namespace": "monitoring"}'
|
||||
```
|
||||
|
||||
### Gitea операции:
|
||||
|
||||
```bash
|
||||
# Список репозиториев
|
||||
curl -X POST http://localhost:3002/api/repos/list \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"owner": "admin"}'
|
||||
|
||||
# Содержимое файла
|
||||
curl -X POST http://localhost:3002/api/repos/file/get \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"owner": "admin", "repo": "k3s-gitops", "path": "apps/loki/statefulset.yaml"}'
|
||||
|
||||
# Список файлов в директории
|
||||
curl -X POST http://localhost:3002/api/repos/tree/get \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"owner": "admin", "repo": "k3s-gitops", "path": "apps"}'
|
||||
```
|
||||
|
||||
## Проверка работы
|
||||
|
||||
```bash
|
||||
# Health checks
|
||||
curl http://localhost:3001/health
|
||||
curl http://localhost:3002/health
|
||||
|
||||
# Статус контейнеров
|
||||
docker-compose ps
|
||||
|
||||
# Логи
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
## Следующие шаги
|
||||
|
||||
1. **На GPU сервере:**
|
||||
```bash
|
||||
curl -sSL https://git.thedevops.dev/admin/k3s-gitops/raw/branch/main/apps/ollama-mcp/install.sh | bash
|
||||
```
|
||||
|
||||
2. **Настроить Gitea токен:**
|
||||
- Получить: https://git.thedevops.dev/user/settings/applications
|
||||
- Добавить в `~/ollama-mcp/.env`
|
||||
- Перезапустить: `docker-compose restart`
|
||||
|
||||
3. **Проверить работу:**
|
||||
```bash
|
||||
curl http://localhost:3001/health
|
||||
curl http://localhost:3002/health
|
||||
```
|
||||
|
||||
4. **Интегрировать с Ollama:**
|
||||
- Создать промпт-шаблоны
|
||||
- Настроить wrapper скрипты
|
||||
- Или использовать прямые curl запросы
|
||||
|
||||
## Поддержка
|
||||
|
||||
- **Документация:** `apps/ollama-mcp/README.md`
|
||||
- **Быстрый старт:** `apps/ollama-mcp/QUICKSTART.md`
|
||||
- **Issues:** https://git.thedevops.dev/admin/k3s-gitops/issues
|
||||
|
||||
## Безопасность
|
||||
|
||||
- Kubeconfig защищен (права 600)
|
||||
- Gitea токен в переменных окружения
|
||||
- Изолированная Docker сеть
|
||||
- Порты по умолчанию только на localhost
|
||||
|
||||
---
|
||||
|
||||
**Готово к установке!** 🚀
|
||||
|
||||
Просто выполни на GPU сервере:
|
||||
```bash
|
||||
curl -sSL https://git.thedevops.dev/admin/k3s-gitops/raw/branch/main/apps/ollama-mcp/install.sh | bash
|
||||
```
|
||||
Reference in New Issue
Block a user