MCP 서버 플레이그라운드

이 저장소는 TypeScript로 구축된 MCP 서버를 실험해 볼 수 있는 공간입니다. MCP 서버 구축 튜토리얼과 비디오의 맞춤형 버전으로, Calude Desktop 및 Cursor IDE와의 통합을 테스트하는 학습 자료이자 플랫폼으로 활용될 수 있도록 제작되었습니다.

배경

이 프로젝트는 다음의 자료를 바탕으로 작성되었습니다:

• 10분 이내에 TypeScript로 첫 번째 MCP 서버를 구축하세요
• MCP 서버 튜토리얼 비디오

원래 튜토리얼은 제가 확장한 기반을 제공했습니다. 튜토리얼의 예제와 함께, 이 코드를 MCP 서버 실험을 위한 강력한 놀이터로 발전시키기 위해 추가 도구와 기능을 추가할 계획입니다.

특징

• TypeScript 기반 서버: 더 나은 구조와 오류 검사를 위해 TypeScript를 활용합니다.
• 모듈식 디자인: 새로운 명령, 기능 및 통합으로 쉽게 확장할 수 있습니다.
• 통합 준비 완료: Calude Desktop 및 Cursor IDE와 함께 작동하도록 설계되어 개발 경험이 향상되었습니다.
• 확장 가능한 플레이그라운드: 튜토리얼 예제를 넘어 추가 도구와 수정 사항을 실험해 볼 수 있는 샌드박스 환경입니다.

시작하기

필수 조건

• Node.js(v12 이상)
• npm(또는 선호도에 따라 Yarn)
• TypeScript(전역적으로 설치되지 않은 경우)

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 MCP Server Playground를 자동으로 설치하려면:

지엑스피1

설치

1. 저장소를 복제합니다.
   git clone <repo_url> cd mcp-server-playground
2. 종속성 설치:
   npm install
3. 프로젝트를 빌드하세요:
   npm run build

구성

이 프로젝트는 환경 변수를 사용합니다. 구성 옵션을 설정하려면 .env 파일을 만드세요. 향후 예제 파일( .env.example )이 제공되면 템플릿으로 사용하세요.

개발

• IDE 통합:
  • Cursor IDE 및 Calude Desktop과 원활하게 작동하도록 설계되었습니다.
  • 이러한 IDE가 지원하는 기본 도구와 확장 기능을 활용하여 생산성을 극대화하세요.
• 프로젝트 확장:
  • 자유롭게 새로운 명령이나 통합을 추가하거나 기존 기능을 수정하세요.
  • 서버의 모듈식 구조 덕분에 추가 도구와 기능을 쉽게 추가할 수 있습니다.

프로젝트 구조

사용 가능한 스크립트

• npm run build - TypeScript 코드를 컴파일하고 적절한 권한을 설정합니다.
• npm run prepare - 빌드 스크립트 실행(git hooks에 유용함)
• npm run watch - TypeScript 파일의 변경 사항을 감시합니다.
• npm run inspector - MCP 검사기 도구를 실행합니다.

기여하다

기여를 환영합니다! 제안, 개선 사항 또는 새로운 통합 기능이 있으시면 저장소를 포크하고 변경 사항을 담은 풀 리퀘스트를 생성해 주세요.

참고문헌

• 10분 이내에 TypeScript로 첫 번째 MCP 서버를 구축하세요
• MCP 서버 튜토리얼 비디오
• 모델 컨텍스트 프로토콜 SDK 문서

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

노트

이 프로젝트는 MCP 서버의 다양한 적응 및 통합을 테스트하기 위한 샌드박스 환경입니다. 새로운 도구와 아이디어가 개발됨에 따라 업데이트 및 확장이 이루어질 예정입니다.

로드맵

• [ ] 튜토리얼 예제 외에 추가 도구 통합을 구현합니다.
• [ ] 각 도구에 대한 포괄적인 설명서를 추가합니다.
• [ ] Calude Desktop을 사용하여 예제 통합 만들기
• [ ] 커서 IDE 통합을 위한 사용자 정의 도구 개발
• [ ] 테스트 프레임워크 및 예제 추가