프로젝트와 도구의 범위 정하기

필요한 구성 요소를 배웠으니 이제 완전한 서버를 만듭니다. 이 종합 프로젝트에서는 실제 서비스 하나를 깔끔하고 설치 가능한 MCP 서버로 구성합니다. 🚀

코드를 작성하기 전에 서버가 도와줄 작업을 정하세요. ‘내 노트 검색’처럼 명확한 목표를 세우면 이후의 모든 결정이 작고 집중된 상태로 유지됩니다.

노트 폴더, SQLite 데이터베이스 또는 하나의 공개 API처럼 구체적인 백엔드 하나를 선택하세요. 데이터 원천을 하나로 제한해야 종합 프로젝트를 완성할 수 있고 범위가 지나치게 커지지 않습니다.

AI가 검색, 읽기, 추가처럼 무엇을 할 수 있어야 하는지 적어 보세요. 이 짧은 기능 목록이 tool과 resource를 구성하는 지도가 됩니다.

목록을 나누세요. 상태를 변경하는 것은 tool이고, 컨텍스트만 가져오는 것은 resource입니다. 이 구분으로 각 기본 요소를 미리 결정할 수 있습니다.

각 tool에 대해 이름, 인수, 반환값을 간단히 적으세요. 빠르게 시그니처를 구상하면 로직을 작성하기 훨씬 전에 누락된 입력을 발견할 수 있습니다.

특정 ID로 노트 하나를 읽는 것처럼 읽기 전용 컨텍스트 하나를 resource로 노출하세요. resource는 동작을 수행하지 않고 모델에 정보를 제공합니다.

사용자가 실행할 수 있는 재사용 가능한 prompt 하나를 추가하세요. 예를 들어 ‘이 노트를 요약해 줘’와 같은 요청입니다. prompt는 최선의 지침을 묶어 호출자가 매번 다시 입력하지 않게 합니다.

완료 상태가 무엇인지 지금 결정하세요. 서버가 로드되고, tool 세 개를 나열하며, 실제 질의 하나에 답하면 됩니다. 명확한 범위를 정하면 끝없는 기능 추가를 막을 수 있습니다.

notes-mcp처럼 짧고 설명적인 이름을 프로젝트에 지정하세요. 클라이언트가 이 이름을 사용자에게 보여 주므로, 무엇을 하는지 즉시 알 수 있게 정하세요.

목표, 백엔드, tool, resource, prompt를 하나의 짧은 사양 파일에 기록하세요. 이 문서가 나머지를 만들 때 사용할 확인 목록이 됩니다.

하나의 목표, 하나의 백엔드, 그리고 tool·resource·prompt로 이루어진 간결한 목록으로 실제 프로젝트의 범위를 정했습니다. 명확한 계획이 구현을 쉽게 만듭니다. 🎯