Brain-MCP開発者向けドキュメント：人間ではなくClaude AIのためのツール

会話を超えてClaudeに記憶を与えるBrain-MCPサーバーをメンテナンスしている開発者は、彼らのドキュメントの主な利用者が人間のGitHub読者ではなくClaudeであることに気づきました。彼らはREADMEの上部に「AIアシスタント向け」セクションを追加し、単なるツールの説明ではなく行動指針を含めました。

実験から得られた重要な詳細

開発者はbrainmcp.dev/for-aiに専用ページを作成し、AIアシスタント向けの具体的なガイダンスを提供しました。README内の行動指針は、ツール使用のためのシステムプロンプトのように機能します。

すぐに観察された違いは、Claudeがツールをより知的に使用し始めたことです。明示的に求められた時だけでなく、ユーザーが話題を切り替えた時には積極的に関連するコンテキストを注入するようになりました。

AI向けドキュメントのパターン

開発者は、もしあなたのMCPサーバーがAIによって利用されるなら、AI向けに特別にドキュメントを書くべきだと提案しています。これには以下が含まれます：

• 単なるツール名とパラメータタイプだけでない
• ツールを効果的に使用するタイミングと方法に関する実際のガイダンス
• Claudeがツールを使用する方法に影響を与える行動指針

ドキュメントからの具体的な例

ドキュメントには以下のような実践的なガイダンスが含まれています：

• 積極的に検索するタイミング（例：ユーザーが「どこまで進んだっけ」と言った時 → tunnel_stateを呼び出す）
• 結果の提示方法（「合成し、生の検索結果をダンプしない」）
• 検索しないタイミング（純粋なコマンド、同じスレッドの継続）

技術的な詳細

Brain-MCPサーバーは以下のコマンドでインストールできます：pipx install brain-mcp && brain-mcp setup

このプロジェクトには25のツールが含まれており、100%ローカルで動作し、MITライセンスで提供されています。

開発者は、他のMCP開発者に対し、基本的なツール説明を超えてClaudeがツールを使用する方法に影響を与える類似のアプローチを試したことがあるか尋ねています。