MCP 서버 템플릿

필수 조건

LLM CLI 설치

이 프로젝트를 실행하려면 LLM CLI 설치가 필요합니다. Homebrew를 사용하여 설치할 수 있습니다.

지엑스피1

설치 후 다음을 실행하여 llm 명령을 PATH에서 사용할 수 있는지 확인하세요.

시작하기

개발

1. 종속성 설치:
   npm install
2. 핫 리로드로 개발 서버를 시작합니다.
   npm run dev
3. 프로젝트를 빌드하세요:
   npm run build
4. 테스트 실행:
   npm test
5. 프로덕션 서버를 시작합니다.
   npm start

건축가 도구

Architect 도구( src/tools/architect.ts )는 아키텍처 설계 피드백을 위해 LLM CLI와 상호 작용할 수 있는 인터페이스를 제공합니다. 대화 컨텍스트를 유지하고 애플리케이션과 LLM CLI 간의 통신을 처리합니다.

특징

• 여러 상호 작용에서 대화 맥락을 유지합니다.
• LLM CLI를 통해 명령 실행을 처리합니다.
• 오류 처리 및 로깅 제공
• 새로운 대화와 지속적인 토론을 모두 지원합니다.

요구 사항

• LLM CLI가 설치되어 PATH에 사용 가능해야 합니다(필수 조건 섹션 참조)
• LLM CLI에 대한 환경 변수는 적절하게 구성되어야 합니다.

테스트

템플릿에는 로컬 테스트를 위한 내장 TestClient와 시각적 디버깅을 위한 MCP Inspector가 포함되어 있습니다.

TestClient 사용

TestClient는 도구를 테스트하는 간단한 방법을 제공합니다.

MCP Inspector 사용

템플릿에는 도구의 시각적 디버깅을 위한 MCP 검사기가 포함되어 있습니다.

1. 검사기를 시작합니다.
   npx @modelcontextprotocol/inspector node dist/index.js
2. http://localhost:5173 에서 검사기 UI를 엽니다.

검사관은 다음을 제공합니다.

• 테스트 도구를 위한 시각적 인터페이스
• 실시간 요청/응답 모니터링
• 도구 메타데이터 검사
• 대화형 테스트 환경

커서를 사용한 로컬 테스트

Cursor를 사용하여 로컬로 MCP 서버를 테스트하려면:

1. 패키지를 빌드하고 연결하세요.
   npm run build npm run link
2. 바이너리가 작동하는지 확인하세요.
   npx architect-test-mcp-tool
3. 커서에 서버를 추가합니다.
   • 커서 설정 열기
   • 기능 탭으로 이동
   • MCP 서버 섹션으로 스크롤하세요
   • "서버 추가"를 클릭하세요
   • "명령" 유형을 선택하세요
   • 이름을 지정합니다(예: "로컬 예제 도구")
   • 명령을 입력하세요: npx architect-test-mcp-tool
   • 확인을 클릭하세요
4. MCP 서버 섹션에 서버가 실행 중으로 표시되는지 확인하여 Cursor에서 서버가 올바르게 시작되는지 확인하세요.

참고: 코드를 변경한 경우 다시 빌드하고 다시 링크하는 것을 잊지 마세요.

테스트가 끝나면 패키지의 연결을 해제할 수 있습니다.

이렇게 하면 개발 중에 생성된 글로벌 심볼릭 링크가 제거됩니다.

문제 해결

MCP Inspector 사용

MCP Inspector는 MCP 서버 디버깅 및 검사에 유용한 도구입니다. 사용 방법은 다음과 같습니다.

1. 먼저 프로젝트를 빌드하세요.
   npm run build
2. 검사기를 실행합니다.
   npx @modelcontextprotocol/inspector node dist/index.js

검사기는 다음을 수행할 수 있는 웹 인터페이스를 제공합니다.

• 사용 가능한 모든 도구와 해당 스키마 보기
• 테스트 도구는 대화형으로 호출합니다.
• 요청/응답 페이로드 검사
• 서버와 클라이언트 간 통신 문제 디버깅