Show GN: Spring AI Playground - MCP 툴 작성부터 테스트, 외부 연동까지 지원하는 데스크톱 앱
(github.com/spring-ai-community)안녕하세요.
최근 Claude Code나 Cursor 같은 AI 에이전트의 도움을 받아 MCP(Model Context Protocol) 툴 코드를 작성하고 활용하는 사례가 많아졌습니다. 하지만 막상 작성된 툴 코드를 실제 환경에서 돌려보고 검증하려고 하면 답답한 순간이 많았습니다.
- 이 툴이 정말 제대로 동작하는가?
- 에이전트가 툴을 호출할 때 정확히 어떤 파라미터가 넘어갔고, 에러가 났다면 원인은 무엇인가? (채팅창 UI만으로는 디버깅이 블랙박스에 가깝습니다.)
- 이 툴을 다른 프로젝트나 Claude Desktop 같은 외부 클라이언트에서 재사용하려면? 결국 처음부터 백엔드 서버를 다시 세팅해야 합니다.
이런 불편함을 해결하기 위해, 작성된 MCP 툴 코드를 즉시 실행해 보고, 투명하게 디버깅하며, 외부 클라이언트로 바로 노출할 수 있는 로컬 Tool Lab인 Spring AI Playground를 만들었습니다.
✨ 주요 기능
- Tool Studio: 작성한 JavaScript 툴 로직을 복붙하면 자바나 스프링 지식 없이도 즉시 동작
- 내장 MCP 서버: 검증된 툴을 Claude Desktop, Cursor 등 MCP 호환 클라이언트에 즉시 연결·재사용 가능 (변경사항 즉시 반영)
- MCP Inspector: 입력값, 출력값, 스키마, 실행 로그, 에러를 상세하게 확인
- Agentic Chat: 내가 만든 툴과 로컬 Vector DB(RAG)를 연동하여 하나의 통합 채팅 UI에서 즉각적인 테스트
- 시크릿 관리: API 키를 스크립트에 하드코딩하지 않도록 데스크탑 시크릿저장소 환경에서 안전하게 관리
크로스 플랫폼 데스크톱 앱(Windows, macOS, Linux)으로 제공되며, Docker나 별도 JVM 설치 없이 설치 파일만 다운로드하면 바로 로컬에서 사용할 수 있습니다.
저처럼 MCP 툴을 만들고 테스트하는 과정에서 백엔드 세팅의 번거로움이나 블랙박스 디버깅에 답답함을 느끼셨던 분들에게 유용한 작업대가 되기를 바랍니다.
🔗 링크
- 다운로드 (Windows/macOS/Linux): GitHub Releases
- 문서 (Docs): Documentation
- 저장소 (Repo): GitHub
단순히 툴 코드를 짜는 것 너머, 실제 운영하고 검증하는 관점에서 현재 어떤 방식으로 디버깅하고 계신지 피드백과 의견을 주시면 감사하겠습니다!