Repolode
standardbeagle

standardbeagle/mcp-tui

stdio, SSE, HTTP를 통해 Model Context Protocol(MCP) 서버를 테스트·디버깅·자동화하는 터미널 UI 및 CLI입니다.

대체할 수 있는 제품:Postman

스타
12
포크
2
열린 이슈
15
마지막 커밋
4일 전

어떤 프로젝트인가요?

mcp-tui를 사용하면 터미널에서 Model Context Protocol 서버에 연결하고, 도구를 선택한 다음 입력 스키마에 따라 생성된 양식을 작성해 호출할 수 있습니다. 각 호출은 동일한 동작을 하는 CLI 명령으로 복사할 수도 있어, 수동으로 확인한 내용을 셸 스크립트나 CI 작업으로 옮길 수 있습니다.

연결에 실패하면 잘못된 경로로 인한 HTTP 404, 전송 방식 불일치, 로그를 stdout에 쓰는 stdio 서버, OAuth 로그인 누락 등 구체적인 원인과 권장 해결 방법을 안내합니다. 또한 양방향 JSON-RPC 메시지와 HTTP 소요 시간, OAuth 흐름의 각 단계를 기록하며, 자격 증명은 마스킹합니다.

이 프로젝트에는 사양 및 보안 점검을 위한 `verify` 명령과 프로토콜 시나리오를 실행하고 JUnit 보고서를 생성하는 `conform` 명령이 포함되어 있습니다. 공식 MCP Go SDK를 기반으로 하며 `go install`과 npm을 통해 배포됩니다.

핵심 기능

  • 01TUI에서 각 도구의 입력 스키마를 바탕으로 도구 호출 양식을 생성합니다.
  • 02CLI에서 동일한 호출을 실행하고 jq에서 사용할 수 있는 JSON 출력을 제공합니다.
  • 03연결 실패의 원인과 해결 방법을 안내합니다.
  • 04모든 JSON-RPC 메시지와 HTTP 소요 시간, OAuth 단계를 기록합니다.
  • 05TUI 세션을 재실행 가능한 셸 스크립트로 내보냅니다.
  • 06CI용 JUnit 적합성 보고서를 생성합니다.

활용 사례

  • 새 MCP 서버의 도구를 AI 클라이언트에 연결하기 전에 수동으로 테스트합니다.
  • MCP 서버가 HTTP 또는 stdio를 통해 연결되지 않는 원인을 디버깅합니다.
  • CI 파이프라인에 MCP 서버 적합성 검사를 추가합니다.
  • 셸에서 MCP 서버를 대상으로 반복 가능한 도구 호출을 스크립트로 작성합니다.

빠른 시작

  1. 1

    Go로 설치

    go install github.com/standardbeagle/mcp-tui@latest
  2. 2

    또는 npm으로 설치

    npm install -g @standardbeagle/mcp-tui
  3. 3

    HTTP MCP 서버에 연결해 TUI 열기

    mcp-tui --url http://localhost:8080/mcp

사용 전 알아둘 점

  • 아직 초기 단계인 프로젝트로, 별이 12개뿐이라 도입 사례와 실적이 제한적입니다.

토픽

자주 묻는 질문

mcp-tui은(는) 무엇인가요?
stdio, SSE, HTTP를 통해 Model Context Protocol(MCP) 서버를 테스트·디버깅·자동화하는 터미널 UI 및 CLI입니다. mcp-tui를 사용하면 터미널에서 Model Context Protocol 서버에 연결하고, 도구를 선택한 다음 입력 스키마에 따라 생성된 양식을 작성해 호출할 수 있습니다. 각 호출은 동일한 동작을 하는 CLI 명령으로 복사할 수도 있어, 수동으로 확인한 내용을 셸 스크립트나 CI 작업으로 옮길 수 있습니다.
mcp-tui은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-tui은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-tui은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mcp-tui의 마지막 커밋은 2026년 10월 18일입니다.
mcp-tui은(는) 어디에 사용할 수 있나요?
새 MCP 서버의 도구를 AI 클라이언트에 연결하기 전에 수동으로 테스트합니다. MCP 서버가 HTTP 또는 stdio를 통해 연결되지 않는 원인을 디버깅합니다. CI 파이프라인에 MCP 서버 적합성 검사를 추가합니다. 셸에서 MCP 서버를 대상으로 반복 가능한 도구 호출을 스크립트로 작성합니다.
mcp-tui는 어떻게 설치하나요?
Go로 설치: go install github.com/standardbeagle/mcp-tui@latest 또는 npm으로 설치: npm install -g @standardbeagle/mcp-tui HTTP MCP 서버에 연결해 TUI 열기: mcp-tui --url http://localhost:8080/mcp
mcp-tui은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/standardbeagle/mcp-tui

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트