mcp connectors - 사내 시스템 연계용 MCP 서버를 구현/ 검증해주는 도구
스크린샷
스크린샷 4장 중 1번째
개발 배경
회사에서 AI 에이전트를 쓰다 보면 결국 사내 시스템과 연결해야 하는 순간이 옵니다.
코드 저장소, RDB, DW, 메타정보 카탈로그, 내부 API까지요.
MCP가 그 연결 표준이라는 건 알았지만, 막상 시작하려니 서버마다 구조가 제각각이고 인증, 로그, 개인정보 마스킹 같은 보안 처리도 매번 새로 고민해야 했어요.
그래서 사내 시스템용 MCP 서버를 늘 같은 방식으로 만들고, 검증하고, 운영하는 오픈소스 모노레포를 만들었습니다.
주요 기능
- 스펙으로 서버 만들기: Claude Code 스킬이 인터뷰로 정의서를 쓰고, 그 정의서대로 서버, 테스트, 시나리오를 생성합니다
- 공통 가드레일: API Key 인증, CORS, PII 마스킹, 외부 텍스트 신뢰 경계, 재시도, 감사 로그를 모든 서버가 함께 씁니다
- Inspector와 Chat: 웹 UI에서 도구를 하나씩 호출해 보고, Claude나 GPT 같은 실제 LLM이 도구를 쓰는 과정을 Trace로 확인합니다
- NL2SQL 레퍼런스: 에이전트가 쓴 SQL을 읽기 전용 강제, 행 수 제한, 카티션 조인 차단 같은 가드레일 뒤에서 실행합니다
docker compose up 한 번이면 LLM 키 없이도 바로 실행해볼 수 있어요.
라이선스는 Apache-2.0입니다.
어떻게 만들었나요?
- 규칙부터 정했습니다
CLAUDE.md에 코딩 컨벤션, 디렉토리 구조, 문서 작성 규칙을 적어 두고 시작했어요. 세션이 바뀌어도 Claude가 같은 규칙으로 일하게 만드는 것이 가장 효과가 컸습니다.
- 계획을 단계로 쪼갰습니다
PRD와 작업 계획을 먼저 쓰고, 개편은 Phase 1부터 6까지 나눠 하나씩 진행했습니다. 단계마다 브랜치를 따고, 끝나면 검증 기록을 남긴 뒤 병합했어요.
- 서브에이전트에게 역할을 나눴습니다
백엔드(Python, pytest), Next.js 페이지, UI 마크업(shadcn), 코드 리뷰 에이전트를 따로 두었습니다. 구현이 끝나면 리뷰 에이전트가 한 번 더 확인합니다.
- 반복 작업은 스킬로 만들었습니다
MCP 서버 정의서 작성(/mcp-spec-writer)과 서버 생성(/mcp-server-builder)을 Claude Code 스킬로 만들어 저장소에 함께 넣었습니다. 다음 개발자도 같은 방식으로 30분 안에 서버를 추가할 수 있게 하는 게 목표였어요.
- 검증은 자동화했습니다
pytest, vitest, Playwright e2e, CLI 시나리오 테스트를 두고, Claude가 코드를 고칠 때마다 돌리게 했습니다.
돌아보면 프롬프트를 잘 쓰는 것보다 규칙과 계획을 문서로 남겨 두는 것이 훨씬 중요했습니다.
- 사용 도구
댓글 0
아직 댓글이 없어요
이 글에 첫 댓글을 달아보세요.