Brain-MCP 개발자 문서: 인간 대신 Claude AI를 위한 도구

Brain-MCP 서버(Claude에게 대화 간 메모리를 제공함)를 유지 관리하는 개발자는 자신의 문서의 주요 소비자가 인간 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가 자신들의 도구를 사용하는 방식에 영향을 미치기 위해 유사한 접근법을 실험해 보았는지 묻고 있습니다.