MCP 서버 플레이그라운드
이 저장소는 TypeScript로 구축된 MCP 서버를 실험해 볼 수 있는 공간입니다. MCP 서버 구축 튜토리얼과 비디오의 맞춤형 버전으로, Calude Desktop 및 Cursor IDE와의 통합을 테스트하는 학습 자료이자 플랫폼으로 활용될 수 있도록 제작되었습니다.
배경
이 프로젝트는 다음의 자료를 바탕으로 작성되었습니다:
원래 튜토리얼은 제가 확장한 기반을 제공했습니다. 튜토리얼의 예제와 함께, 이 코드를 MCP 서버 실험을 위한 강력한 놀이터로 발전시키기 위해 추가 도구와 기능을 추가할 계획입니다.
Related MCP server: Browser-use MCP Server
특징
TypeScript 기반 서버: 더 나은 구조와 오류 검사를 위해 TypeScript를 활용합니다.
모듈식 디자인: 새로운 명령, 기능 및 통합으로 쉽게 확장할 수 있습니다.
통합 준비 완료: Calude Desktop 및 Cursor IDE와 함께 작동하도록 설계되어 개발 경험이 향상되었습니다.
확장 가능한 플레이그라운드: 튜토리얼 예제를 넘어 추가 도구와 수정 사항을 실험해 볼 수 있는 샌드박스 환경입니다.
시작하기
필수 조건
Node.js(v12 이상)
npm(또는 선호도에 따라 Yarn)
TypeScript(전역적으로 설치되지 않은 경우)
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 MCP Server Playground를 자동으로 설치하려면:
지엑스피1
설치
저장소를 복제합니다.
git clone <repo_url> cd mcp-server-playground종속성 설치:
npm install프로젝트를 빌드하세요:
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 검사기 도구를 실행합니다.
기여하다
기여를 환영합니다! 제안, 개선 사항 또는 새로운 통합 기능이 있으시면 저장소를 포크하고 변경 사항을 담은 풀 리퀘스트를 생성해 주세요.
참고문헌
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
노트
이 프로젝트는 MCP 서버의 다양한 적응 및 통합을 테스트하기 위한 샌드박스 환경입니다. 새로운 도구와 아이디어가 개발됨에 따라 업데이트 및 확장이 이루어질 예정입니다.
로드맵
[ ] 튜토리얼 예제 외에 추가 도구 통합을 구현합니다.
[ ] 각 도구에 대한 포괄적인 설명서를 추가합니다.
[ ] Calude Desktop을 사용하여 예제 통합 만들기
[ ] 커서 IDE 통합을 위한 사용자 정의 도구 개발
[ ] 테스트 프레임워크 및 예제 추가