Документы для разработчиков 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
👀 Смотрите также
Altimate Code: Открытый агентный инструментарий для инженерии данных
Altimate Code — это открытый фреймворк, предоставляющий детерминированные инструменты для инженерии данных для AI-агентов, решающий такие проблемы, как галлюцинированный SQL и отсутствие контекста схемы. Он включает отслеживание происхождения на уровне столбцов, обнаружение SQL-антипаттернов и интеграцию с dbt, с показателями производительности 74,4% на ADE-bench.
Виджур: Простой пользовательский интерфейс для публикации на GitHub Pages
Weejur — это бесплатный инструмент, предоставляющий упрощённый интерфейс для публикации сайтов через GitHub Pages, позволяющий пользователям вставлять HTML-код или загружать файлы после OAuth-авторизации.
Навыки агента HuggingFace: Стандартизированные определения задач ИИ для кодирующих агентов
HuggingFace Skills — это автономные папки с YAML-фронтматером и инструкциями для ИИ-агентов, предназначенные для выполнения конкретных задач машинного обучения, таких как создание наборов данных, обучение моделей и их оценка. Они совместимы с OpenAI Codex, Claude Code от Anthropic, Google Gemini CLI и Cursor.
SymDex: Открытый MCP-индексатор кода сокращает потребление токенов ИИ-агентами
SymDex — это инструмент с открытым исходным кодом для индексирования кода по протоколу MCP. Он предварительно индексирует базы кода, чтобы помочь AI-агентам для программирования находить функции и классы без чтения целых файлов, что, согласно тестам разработчика, сокращает использование токенов примерно на 97% за один поиск.