MCP Tools CLI 완벽 가이드 — MCP 서버를 터미널에서 제어하는 법

AI 에이전트 생태계가 폭발적으로 성장하면서 Model Context Protocol (MCP)이라는 새로운 표준이 등장했습니다. Claude, GPT, Gemini 같은 LLM이 외부 도구와 상호작용하기 위한 공통 프로토콜인데요. 문제는 이 MCP 서버들을 테스트하고 디버깅할 방법이 마땅치 않았다는 점입니다.

오늘 소개할 MCP Tools는 이 문제를 정면으로 해결하는 CLI 도구입니다. 터미널 하나로 MCP 서버의 기능을 확인하고, 도구를 호출하고, 리소스를 탐색할 수 있죠. 1,500개 이상의 GitHub 스타를 받으며 개발자들 사이에서 빠르게 주목받고 있습니다.

MCP Tools란?

MCP Tools는 Go 언어로 작성된 오픈소스 CLI 애플리케이션입니다. MCP 서버와 JSON-RPC 2.0 프로토콜로 통신하며, stdio와 HTTP 두 가지 전송 방식을 모두 지원합니다. 쉽게 말해 "MCP 서버를 위한 swiss army knife"라고 할 수 있습니다.

핵심 목표는 터미널에서 직접 MCP 서버를 검사하고 조작하는 것입니다. AI 에이전트를 통해 간접적으로 확인하던 것을 CLI로 직접 할 수 있게 해주죠. 이건 개발 속도를 획기적으로 높여줍니다.

설치 방법

설치는 두 가지 방법으로 가능합니다.

Homebrew (macOS/Linux)

brew tap f/mcptools

brew install mcp

Go 설치

go install github.com/f/mcptools/cmd/mcptools@latest

Go가 설치되어 있다면 두 번째 방법이 더 빠릅니다. 두 방법 모두 mcp 명령어를 사용할 수 있게 해줍니다.

핵심 기능

MCP Tools는 6개의 주요 서브커맨드를 제공합니다.

1. tools — 사용 가능한 도구 목록

MCP 서버에서 제공하는 도구들을 표 형태로 보여줍니다.

mcp tools npx -y @modelcontextprotocol/server-filesystem ~/Code

이 명령어 하나로 파일 시스템 서버가 어떤 기능을 제공하는지 즉시 확인할 수 있습니다.

2. resources — 리소스 탐색

서버가 노출하는 리소스(데이터, 파일 등)를 조회합니다.

mcp resources npx -y @modelcontextprotocol/server-filesystem ~/Code

3. prompts — 프롬프트 목록

서버에 정의된 프롬프트 템플릿을 확인합니다.

mcp prompts npx -y @modelcontextprotocol/server-filesystem ~/Code

4. call — 도구 직접 호출

가장 강력한 기능입니다. 서버의 도구를 직접 호출하고 결과를 확인할 수 있습니다.

mcp call npx -y @modelcontextprotocol/server-filesystem ~/Code read_file --path "./README.md"

5. shell — 인터랙티브 셸 모드

이 기능이 진짜 매력입니다. 영구 연결을 유지하는 인터랙티브 셸을 열어서 여러 명령을 연속으로 실행할 수 있습니다.

mcp shell npx -y @modelcontextprotocol/server-filesystem ~/Code

셸 모드에서는 서버와의 연결이 유지되므로, 도구를 여러 번 호출하거나 리소스를 순차적으로 탐색하는 작업에 매우 효율적입니다.

6. 출력 포맷 커스텀

세 가지 출력 형식을 지원합니다:

• table (기본) — 읽기 쉬운 표 형식
• json — 파이프라인 처리용 JSON



• pretty — 들여쓰기된 JSON

--format 플래그로 전환: mcp tools --format pretty npx -y @modelcontextprotocol/server-filesystem ~/Code

실전 예제: GitHub MCP 서버 테스트

실제 개발에서 MCP Tools를 어떻게 활용하는지 보겠습니다. GitHub MCP 서버를 예제로 사용해보죠.

Step 1: 서버 기능 확인

mcp tools npx -y @modelcontextprotocol/server-github

이 명령어로 GitHub 서버가 제공하는 모든 도구 목록을 확인합니다. 어떤 API가 사용 가능한지 한눈에 파악할 수 있죠.

Step 2: 셸 모드로 연결

mcp shell npx -y @modelcontextprotocol/server-github

인터랙티브 셸이 열리면, 파일 읽기, 디렉토리 탐색, 검색 등을 연속적으로 수행할 수 있습니다. 매번 서버를 초기화할 필요가 없어서 속도가 훨씬 빠릅니다.

Step 3: CI/CD 파이프라인에서 활용

JSON 출력 모드를 사용하면 CI/CD 파이프라인에도 쉽게 통합할 수 있습니다:

mcp tools --format json npx -y @your-mcp-server | jq '.[] | select(.name | contains("search"))'

jq와 결합하면 특정 도구만 필터링하거나, 서버 상태를 검증하는 자동화 테스트도 작성할 수 있습니다.

왜 MCP Tools가 필요한가?

MCP 생태계가 빠르게 성장하면서 수많은 MCP 서버가 쏟아지고 있습니다. 파일 시스템, GitHub, 데이터베이스, 웹 검색, 슬랙, 노션 등 거의 모든 서비스에 MCP 서버가 등장했죠.

하지만 이 서버들이 "정말로" 어떤 기능을 제공하는지 확인하려면 AI 에이전트를 통해 간접적으로 테스트해야 했습니다. 이건 비효율적이고, 디버깅도 어렵습니다.

MCP Tools는 이 문제를 세 가지로 해결합니다:

• 직접 검사 — AI 에이전트 없이 서버 기능을 직접 확인
• 빠른 디버깅 — 셸 모드로 즉각적인 피드백
• 자동화 — JSON 출력으로 CI/CD 통합

대안 비교

MCP 서버 테스트 도구는 점점 늘어나고 있습니다:

• Cursor / Claude Desktop — IDE/앱 내장, 하지만 터미널 접근 불가
• mcporter — Python 기본, MCP 서버 관리에 특화
• MCP Tools — Go 기반, 가볍고 CLI 네이티브, 셸 모드 지원

순수 CLI 환경에서 작업하거나, 서버 개발/테스트가 주업무라면 MCP Tools가 가장 직관적인 선택입니다. 특히 Go로 작성되어 바이너리 하나로 배포되므로 의존성 걱정이 없습니다.

요약

MCP Tools는 AI 에이전트 시대의 필수 CLI 도구입니다. MCP 서버를 개발하거나, 기존 서버를 테스트하거나, CI/CD에 통합하려는 모든 개발자에게 추천합니다.

핵심 포인트:

• Go 기반 경량 CLI — 단일 바이너리, 의존성 없음
• stdio + HTTP 전송 지원 — 모든 MCP 서버와 호환
• 인터랙티브 셸 모드 — 연속 작업에 최적화
• JSON 출력 — 자동화 및 파이프라인에 바로 통합
• 1,500+ GitHub 스타 — 활발한 커뮤니티

GitHub: github.com/f/mcptools