MCP(모델 컨텍스트 프로토콜) 서버와 상호작용하기 위한 경량의 Bun 기반 CLI입니다.

특징

• 🪶 경량 - 의존성 최소화, 빠른 시작
• 📦 단일 바이너리 - [[T0]를 통해 독립 실행형 실행 파일로 컴파일됨
• 🔧 셸 친화적 - 호출용 JSON 출력, jq가 포함된 파이프, 체인 지원
• 🤖 Agent-Optimized - AI 코딩 에이전트(Gemini CLI, Claude Code 등)를 위해 설계되었습니다.
• 🔌 Universal - stdio와 HTTP MCP 서버 모두를 지원합니다
• ⚡ 연결 풀링 - 레이지스폰 데몬이 연결을 따뜻하게 유지함 (60초 유휴 타임아웃)
• 툴 필터링 - 설정을 통해 서버별로 특정 도구를 허용/비활성화
• 📋 서버 명령어 - 출력에 MCP 서버 명령어 표시
• 💡 실행 가능한 오류 - 사용 가능한 서버와 복구 제안이 포함된 구조화된 오류 메시지

퀵 스타트

1. 설치

또는

2. 설정 파일을 생성하세요

현재 디렉터리 또는 ~/.config/mcp/에서 mcp_servers.json를 생성하세요:

3. 사용 가능한 도구 발견하기

4. 도구를 불러주세요

사용

두 형식 모두 작동: info 또는 info /

[! 팁] 설명을 포함하는 명령어에 -d를 추가하세요.

옵션

mcp-cli

A lightweight, Bun-based CLI for interacting with MCP (Model Context Protocol) servers.

Features

• 🪶 Lightweight - Minimal dependencies, fast startup
• 📦 Single Binary - Compile to standalone executable via bun build --compile
• 🔧 Shell-Friendly - JSON output for call, pipes with jq, chaining support
• 🤖 Agent-Optimized - Designed for AI coding agents (Gemini CLI, Claude Code, etc.)
• 🔌 Universal - Supports both stdio and HTTP MCP servers
• ⚡ Connection Pooling - Lazy-spawn daemon keeps connections warm (60s idle timeout)
• � Tool Filtering - Allow/disable specific tools per server via config
• 📋 Server Instructions - Display MCP server instructions in output
• �💡 Actionable Errors - Structured error messages with available servers and recovery suggestions

Quick Start

1. Installation

curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash

or

# requires bun install
bun install -g https://github.com/philschmid/mcp-cli

2. Create a config file

Create mcp_servers.json in your current directory or ~/.config/mcp/:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "."
      ]
    },
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

3. Discover available tools

# List all servers and tools
mcp-cli

# With descriptions
mcp-cli -d

4. Call a tool

# View tool schema first
mcp-cli info filesystem read_file

# Call the tool
mcp-cli call filesystem read_file '{"path": "./README.md"}'

Usage

mcp-cli [options]                             List all servers and tools
mcp-cli [options] info                Show server tools and parameters
mcp-cli [options] info          Show tool schema
mcp-cli [options] grep               Search tools by glob pattern
mcp-cli [options] call          Call tool (reads JSON from stdin if no args)
mcp-cli [options] call    Call tool with JSON arguments

Both formats work: info or info /

[!TIP] Add -d to any command to include descriptions.

Options

Output

Commands

List Servers

# Basic listing
$ mcp-cli
github
  • search_repositories
  • get_file_contents
  • create_or_update_file
filesystem
  • read_file
  • write_file
  • list_directory