mcp CLI 알아보기

mcp 명령줄 도구는 [cli] 추가 기능과 함께 설치되었습니다. 별도의 연결 코드를 작성하지 않고도 서버를 실행하고, 테스트하고, 배포할 수 있게 해 줍니다. 🛠️

CLI의 핵심 동사는 세 가지입니다. dev, install, run입니다. 각각 테스트부터 배포까지 서버 작업의 서로 다른 단계를 담당합니다.

도구가 프로젝트 환경에 있으므로 uv run으로 호출합니다. 이렇게 하면 매번 올바른 Python과 패키지가 사용됩니다.

서버를 가장 빠르게 시험하는 방법은 mcp dev입니다. 서버를 실행하고 MCP Inspector를 열어 대화형으로 직접 확인할 수 있습니다.

mcp dev를 사용하면 도구와 리소스를 실시간으로 보고, 직접 호출하고, 응답을 확인할 수 있습니다. 가능한 한 빠른 피드백 순환을 제공하는 방식입니다. 🔍

서버를 일상적으로 사용할 준비가 되면 mcp install이 서버를 Claude Desktop의 설정에 바로 연결하므로 앱이 시작될 때 서버를 불러옵니다.

--name 플래그로 알아보기 쉬운 이름을 전달하면 Claude 안에서 쉽게 찾을 수 있습니다. 명확한 이름이 원시 파일 경로보다 언제나 낫습니다.

일반적인 mcp run 명령은 Inspector를 연결하지 않고 서버를 직접 실행합니다. FastMCP 서버를 클라이언트용으로 시작하는 간단한 방법입니다.

구현하고 디버깅할 때는 mcp dev를 사용하고, 서버만 실행하면 될 때는 mcp run으로 전환하십시오. 같은 서버라도 목적이 다릅니다.

옵션을 잊으셨나요? 모든 명령은 --help를 지원하며 인수와 사용법을 출력합니다. 언제든 곁에 둘 수 있는 가장 빠른 참고 자료입니다.

이 명령들을 함께 사용하면 전체 수명 주기를 처리할 수 있습니다. dev로 테스트하고, install로 배포하며, run으로 실행합니다. 서버를 운영하는 데 다른 기능이 필요한 경우는 드뭅니다. 🔄

이제 dev로 테스트하고, install로 Claude에 서버를 추가하며, run으로 서버를 실행할 수 있습니다. 세 가지 명령으로 서버를 완전히 제어할 수 있습니다. 🎉