Документы для разработчиков Brain-MCP: инструменты для Claude AI, а не для людей
Разработчик, поддерживающий сервер Brain-MCP, который обеспечивает Claude память между диалогами, обнаружил, что основным потребителем их документации был Claude, а не люди, читающие GitHub. Они добавили раздел «Для ИИ-ассистентов» в начало README, содержащий поведенческие инструкции, а не просто описания инструментов.
Ключевые детали эксперимента
Разработчик создал отдельную страницу по адресу brainmcp.dev/for-ai с конкретными рекомендациями для ИИ-ассистентов. Поведенческие инструкции в README функционируют как системный промпт для использования инструментов.
Немедленное наблюдаемое отличие заключалось в том, что Claude начал использовать инструменты более разумно — не только когда его явно просили, но и проактивно добавляя релевантный контекст, когда пользователь менял тему.
Паттерн документации для потребления ИИ
Разработчик предлагает, что если ваш MCP-сервер используется ИИ, вам следует писать документацию специально для ИИ. Это включает:
- Не только названия инструментов и типы параметров
- Фактические рекомендации о том, когда и как эффективно использовать инструменты
- Поведенческие инструкции, которые влияют на то, как Claude использует инструменты
Конкретные примеры из документации
Документация включает практические рекомендации, такие как:
- Когда проактивно искать (например, когда пользователь говорит «на чём я остановился» → вызвать tunnel_state)
- Как представлять результаты («синтезируйте, не вываливайте сырые результаты поиска»)
- Когда НЕ искать (чистые команды, продолжение той же темы)
Технические детали
Сервер Brain-MCP можно установить с помощью: pipx install brain-mcp && brain-mcp setup
Проект включает 25 инструментов, работает на 100% локально и имеет лицензию MIT.
Разработчик спрашивает других разработчиков MCP, экспериментировали ли они с подобными подходами, чтобы влиять на то, как Claude использует их инструменты, выходя за рамки базовых описаний.
📖 Read the full source: r/ClaudeAI
👀 Смотрите также
Codeset улучшает работу кодирующих агентов, предоставляя контекст из истории git, специфичный для репозитория.
Codeset генерирует статические файлы из истории git, которые предоставляют контекст, такой как прошлые ошибки, корневые причины и взаимосвязи совместных изменений. Тестирование показало улучшение на 5,3 п.п. на codeset-gym-python и на 2 п.п. на SWE-Bench Pro с использованием OpenAI Codex.
Chromeflow: Расширение для Chrome автоматизирует задачи веб-интерфейса для Claude
Chromeflow — это бесплатное расширение для Chrome с открытым исходным кодом и сервер MCP, созданный с помощью Claude Code, который предоставляет Claude управление браузером для автоматизации ручных задач веб-интерфейса, таких как настройка Stripe, Supabase или SendGrid. Он подсвечивает элементы для клика, заполняет поля, нажимает кнопку «Сохранить» и записывает API-ключи напрямую в файлы .env.
Реализация локального агента OpenClaw с кэшированием TurboQuant для оборудования среднего класса
Приложение для OpenClaw с локальными моделями теперь работает на устройствах среднего класса, таких как MacBook Air с 16 ГБ оперативной памяти, используя кэширование TurboQuant и прогрев контекста. Реализация включает патчи для llama.cpp для надежного вызова инструментов и достигает 10-15 токенов в секунду с моделями Gemma 4 и QWEN 3.5.
Открытый мозг: Open-source MCP-сервер добавляет постоянную память с авто-графом и семантическим поиском для Claude
Open Brain — это сервер MCP с открытым исходным кодом, который предоставляет Клоду постоянную память между сессиями с автоматическим извлечением сущностей, семантическим дедуплицированием и авто-графированием связей между мыслями. Он использует Supabase с pgvector и Deno Edge Functions, может быть развернут самостоятельно и включает 16 инструментов MCP для обхода графа, просмотра сущностей и синтеза еженедельных обзоров.