cliskill 1.0.4 → 1.0.6

package/README.md

@@ -24,6 +24,7 @@
 - [Использование](#-использование)
 - [Конфигурация](#-конфигурация)
 - [Инструменты](#-инструменты)
+- [MCP серверы](#-mcp-серверы)
 - [Агентская система](#-агентская-система)
 - [Архитектура](#-архитектура)
 - [API провайдеры](#-api-провайдеры)
@@ -345,6 +346,71 @@ cliskill включает 15 встроенных инструментов дл
 
 ---
 
+## 🔌 MCP серверы
+
+**MCP (Model Context Protocol)** — открытый протокол для подключения внешних инструментов к AI-ассистентам. cliskill автоматически запускает MCP-серверы при старте и регистрирует их инструменты как доступные для модели.
+
+### Как это работает
+
+1. cliskill читает `mcpServers` из конфига
+2. Запускает каждый сервер как дочерний процесс (stdio transport)
+3. Получает список инструментов через `tools/list`
+4. Регистрирует их в ToolRegistry с префиксом `mcp_{serverName}_`
+5. Модель может вызывать MCP-инструменты наравне со встроенными
+
+### Настройка
+
+Добавьте массив `mcpServers` в конфиг (`~/.cliskill/config.json` или `.cliskillrc.json`):
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "filesystem",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
+      "transport": "stdio"
+    },
+    {
+      "name": "github",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
+      },
+      "transport": "stdio"
+    }
+  ]
+}
+```
+
+### Поля конфигурации MCP-сервера
+
+| Поле | Тип | Обязательное | Описание |
+|------|-----|:---:|----------|
+| `name` | string | ✅ | Уникальное имя сервера |
+| `command` | string | ✅ | Команда запуска процесса |
+| `args` | string[] | — | Аргументы команды (по умолчанию `[]`) |
+| `env` | object | — | Переменные окружения для процесса |
+| `transport` | string | — | Транспорт: `"stdio"` (по умолчанию) |
+
+### Популярные MCP-серверы
+
+| Сервер | Пакет | Назначение |
+|--------|-------|------------|
+| Filesystem | `@modelcontextprotocol/server-filesystem` | Доступ к файловой системе |
+| GitHub | `@modelcontextprotocol/server-github` | Работа с GitHub API |
+| PostgreSQL | `@modelcontextprotocol/server-postgres` | Запросы к PostgreSQL |
+| Brave Search | `@modelcontextprotocol/server-brave-search` | Веб-поиск через Brave |
+| Memory | `@modelcontextprotocol/server-memory` | Память между сессиями |
+| Puppeteer | `@modelcontextprotocol/server-puppeteer` | Управление браузером |
+
+### Безопасность
+
+- MCP-инструменты наследуют `riskLevel = 'safe'` — требуют разрешения в режиме `ask`
+- Серверы запускаются с переменными окружения из конфига (не из системы)
+- При ошибке подключения сервер пропускается, остальные продолжают работу
+
 ## 🤖 Агентская система
 
 ### Auto Mode

package/dist/bootstrap/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "../chunk-UJMUL64T.js";
+} from "../chunk-S4ZZPUPF.js";
 import "../chunk-AJENHWD3.js";
 export {
   runCli