오늘 MCP Tool Search 기능을 Claude Code에 적용합니다.
MCP가 더 널리 사용되는 프로토콜로 성장하고 에이전트의 기능이 향상됨에 따라, MCP 서버에는 최대 50개 이상의 도구가 포함될 수 있고 많은 컨텍스트를 차지한다는 사실을 발견했습니다.
Tool Search를 사용하면 MCP 도구가 많은 컨텍스트를 차지할 때 Claude Code가 동적으로 도구를 컨텍스트에 로드할 수 있습니다.
작동 방식:
- MCP 도구 설명이 컨텍스트의 10% 이상을 사용할 때 Claude Code가 이를 감지합니다.
- 트리거되면 도구가 사전 로드되는 대신 검색을 통해 로드됩니다.
그 외에는 MCP 도구가 이전과 동일하게 작동합니다.
이 기능은 GitHub에서 가장 많이 요청된 기능 중 하나인 MCP 서버의 지연 로딩을 해결합니다. 사용자들은 7개 이상의 서버가 67,000개 이상의 토큰을 소비하는 설정을 문서화하고 있었습니다.
MCP 서버를 만드는 경우
대부분 동일하지만, 도구 검색이 활성화되면 "서버 지침" 필드가 더 유용해집니다. 이는 스킬과 유사하게 Claude가 도구를 검색할 시기를 알도록 도와줍니다.
MCP 클라이언트를 만드는 경우
ToolSearchTool 구현을 적극 권장합니다. 여기에서 문서를 확인할 수 있습니다. Claude Code에서 작동하도록 커스텀 검색 함수로 구현했습니다.
프로그래매틱 도구 호출은 어떻게 되나요?
MCP 도구가 코드를 통해 서로 구성될 수 있도록 프로그래매틱 도구 호출을 실험했습니다. 앞으로도 계속 탐구할 예정이지만, 가장 중요한 것은 Tool Search를 출시하여 컨텍스트 사용량을 줄이는 것이라고 판단했습니다.
ToolSearchTool이 작동하는 모습을 보시면 여기 또는 GitHub에서 의견을 알려주세요.
