An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.
Python ai-agentsai-automationclaudeclaude-codeebbinghausknowledge-graphllmmemory-systemobsidianpersonal-assistantpkmproductivitypythonsecond-braintelegram-botvoice-assistant
docs: add mcp-cli setup guide
smixse2d7c4fa844c
diff --git a/README.md b/README.mdindex c730038..1f383ed 100644--- a/README.md+++ b/README.md@@ -986,7 +986,11 @@ sudo systemctl start d-brain-bot### MCP-серверы-Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию настроен Todoist, но вы можете подключить любой сервис, для которого есть MCP-сервер:+Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам.++> **Рекомендуем:** Используйте [mcp-cli](docs/mcp-cli-setup.md) для стабильного подключения. Это обёртка с connection pooling и auto-retry — соединения не отваливаются.++По умолчанию настроен Todoist, но вы можете подключить любой сервис, для которого есть MCP-сервер:| Сервис | MCP-сервер | Что можно делать ||--------|------------|------------------|diff --git a/docs/mcp-cli-setup.md b/docs/mcp-cli-setup.mdnew file mode 100644index 0000000..c91adae--- /dev/null+++ b/docs/mcp-cli-setup.md@@ -0,0 +1,194 @@+# MCP через mcp-cli++Стабильное подключение к MCP серверам через mcp-cli вместо прямого протокола.++## Зачем это нужно++MCP протокол напрямую иногда отваливается. mcp-cli решает эту проблему:++- **Connection pooling** - daemon держит соединения+- **Auto-retry** - автоматические повторы при сетевых ошибках+- **Стабильность** - работа через bash надёжнее чем MCP протокол напрямую++## Как это работает++```+До:+Claude → MCP Protocol → Todoist MCP Server → Todoist API+ (отваливается)++После:+Claude → Bash → mcp-cli → Todoist MCP Server → Todoist API+ (daemon, retry, pooling)+```++---++## Установка++### 1. Установите mcp-cli++```bash+curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash+```++Проверка:+```bash+~/.local/bin/mcp-cli --version+# mcp-cli v0.3.0+```++### 2. Создайте конфиг++```bash+mkdir -p ~/.config/mcp+cat > ~/.config/mcp/mcp_servers.json << 'EOF'+{+ "mcpServers": {+ "todoist": {+ "command": "npx",+ "args": ["-y", "@doist/todoist-ai"],+ "env": {+ "TODOIST_API_KEY": "${TODOIST_API_KEY}"+ }+ }+ }+}+EOF+```++### 3. Добавьте токены в shell++```bash+# Добавить в ~/.bashrc+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc+echo 'export TODOIST_API_KEY="ваш_токен"' >> ~/.bashrc+source ~/.bashrc+```++### 4. Уберите прямое MCP подключение из Claude++```bash+# Удалить прямое MCP подключение+claude mcp remove todoist+```++Проверить что удалено:+```bash+claude mcp list+# todoist НЕ должен быть в списке+```++Теперь Claude работает через mcp-cli (bash), а не через MCP протокол напрямую.++---++## Проверка++```bash+# Список инструментов (24 шт)+mcp-cli info todoist++# Тест - задачи на сегодня+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'++# Обзор всех проектов+mcp-cli call todoist get-overview '{}'+```++---++## Todoist Tools (24)++### Задачи++| Tool | Описание |+|------|----------|+| `add-tasks` | Создать задачи |+| `update-tasks` | Обновить задачи |+| `complete-tasks` | Завершить задачи |+| `find-tasks` | Поиск по тексту/проекту/label |+| `find-tasks-by-date` | Задачи по дате |+| `find-completed-tasks` | Завершённые задачи |++### Проекты и секции++| Tool | Описание |+|------|----------|+| `add-projects` | Создать проекты |+| `update-projects` | Обновить проекты |+| `find-projects` | Поиск проектов |+| `add-sections` | Создать секции |+| `update-sections` | Обновить секции |+| `find-sections` | Секции проекта |++### Комментарии и коллаборация++| Tool | Описание |+|------|----------|+| `add-comments` | Добавить комментарии |+| `update-comments` | Обновить комментарии |+| `find-comments` | Найти комментарии |+| `find-project-collaborators` | Участники проекта |+| `manage-assignments` | Bulk назначение |++### Общее++| Tool | Описание |+|------|----------|+| `get-overview` | Обзор (markdown) |+| `find-activity` | Лог активности |+| `delete-object` | Удалить объект |+| `fetch-object` | Получить объект |+| `user-info` | Инфо о пользователе |+| `search` | Универсальный поиск |+| `fetch` | Получить по ID |++---++## Примеры команд++### Задачи на сегодня+```bash+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'+```++### Создать задачу+```bash+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Тест задача", "dueString": "tomorrow", "priority": 2}]}'+```++### Завершить задачу+```bash+mcp-cli call todoist complete-tasks '{"ids": ["task_id_here"]}'+```++### Поиск задач+```bash+mcp-cli call todoist find-tasks '{"searchText": "проект"}'+```++### Обзор проекта+```bash+mcp-cli call todoist get-overview '{"projectId": "project_id"}'+```++### Найти проекты+```bash+mcp-cli call todoist find-projects '{"search": "Work"}'+```++---++## Отладка++```bash+MCP_DEBUG=1 mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'+```++---++## Требования++- Node.js 18+ (для npx)+- Todoist API Token (Settings → Integrations → Developer)