149 lines
3.4 KiB
Markdown
149 lines
3.4 KiB
Markdown
# LazyBear MCP Server
|
||
|
||
.NET 10 сервер Model Context Protocol (MCP) для интеграции Kubernetes инструментов.
|
||
|
||
## Архитектура
|
||
```
|
||
LazyBear.MCP/
|
||
├── Program.cs # HTTP transport MCP сервер
|
||
├── Pages/ # Razor Pages UI
|
||
│ ├── Index.cshtml # Главная страница
|
||
│ └── Shared/ # Общие компоненты
|
||
├── Services/
|
||
│ └── Kubernetes/
|
||
│ ├── K8sConfigTools.cs # Инструменты конфигурации
|
||
│ ├── K8sDeploymentTools.cs # Инструменты деплоя
|
||
│ ├── K8sNetworkTools.cs # Инструменты сети
|
||
│ ├── K8sPodsTools.cs # Инструменты подов
|
||
│ ├── K8sClientFactory.cs # Factory для клиентов
|
||
│ └── K8sClientProvider.cs # Provider для клиентов
|
||
└── appsettings.json # Конфиг (логинг, K8s, allowed hosts)
|
||
```
|
||
|
||
## Быстрый старт
|
||
|
||
```bash
|
||
cd LazyBear.MCP
|
||
dotnet run
|
||
```
|
||
|
||
Сервер работает на `http://localhost:5000`
|
||
|
||
## Примеры интеграции
|
||
|
||
### Codex (Windows конфигурация)
|
||
|
||
Файл: `.mcp.json`
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"lazybear": {
|
||
"command": "dotnet",
|
||
"args": ["run", "--project", "E:\\Codex\\LazyBearWorks\\LazyBear.MCP"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### Continue (расширение VS Code)
|
||
|
||
Файл: `.vscode/continue/config.json`
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"lazybear": {
|
||
"command": "dotnet",
|
||
"args": [
|
||
"run",
|
||
"--project",
|
||
"${workspaceFolder}/LazyBear.MCP"
|
||
],
|
||
"type": "stdio"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### OpenCode (Linux/Mac конфигурация)
|
||
|
||
Файл: `~/.opencode/.mcp.json`
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"lazybear": {
|
||
"command": "dotnet",
|
||
"args": ["run", "--project", "~/LazyBearWorks/LazyBear.MCP"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### Использование через CLI
|
||
|
||
Тестирование через MCP inspector:
|
||
|
||
```bash
|
||
npm install -g @modelcontextprotocol/inspector
|
||
|
||
npx @modelcontextprotocol/inspector dotnet run --project LazyBear.MCP
|
||
```
|
||
|
||
Прямое тестирование через stdin:
|
||
|
||
```bash
|
||
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0"}}}' | dotnet run --project LazyBear.MCP
|
||
```
|
||
|
||
## Доступные инструменты
|
||
|
||
### Kubernetes
|
||
|
||
| Инструмент | Описание |
|
||
|------------|-----------|
|
||
| `K8sConfigTools` | Управление конфигурациями K8s |
|
||
| `K8sDeploymentTools` | Управление деплоями |
|
||
| `K8sNetworkTools` | Управление сетями |
|
||
| `K8sPodsTools` | Управление подами |
|
||
|
||
**Настройка:**
|
||
|
||
```json
|
||
// appsettings.json
|
||
{
|
||
"Kubernetes": {
|
||
"KubeconfigPath": "~/.kube/config",
|
||
"DefaultNamespace": "default"
|
||
},
|
||
"Logging": {
|
||
"LogLevel": {
|
||
"Default": "Information",
|
||
"ModelContextProtocol": "Debug"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## Разработка
|
||
|
||
### Сборка
|
||
```bash
|
||
dotnet build
|
||
```
|
||
|
||
### Запуск
|
||
```bash
|
||
dotnet run
|
||
```
|
||
|
||
### Тестирование с MCP Inspector
|
||
```bash
|
||
npx @modelcontextprotocol/inspector dotnet run --project LazyBear.MCP
|
||
```
|
||
|
||
## License
|
||
|
||
MIT
|