Лёгкий CLI на базе Bun для взаимодействия с серверами MCP (Model Context Protocol).

Особенности

• 🪶 Лёгкий - минимальные зависимости, быстрый запуск
• 📦 Single Binary - Компиляция в автономный исполняемый файл через bun build --compile
• 🔧 Дружественный к оболочке - JSON-вывод для вызова, трубы с jq, поддержка цепей
• 🤖 Optimized-Agent-Optimized — разработано для ИИ-кодировщиков (Gemini CLI, Claude Code и др.)
• 🔌 Universal — поддерживает как stdio, так и HTTP MCP серверы
• ⚡ Пул соединений - Демон, появившийся ленивым, поддерживает соединения в тепле (тайм-аут на 60-х секунд)
• Фильтрация инструментов - Разрешать/отключать определённые инструменты для каждого сервера с помощью конфигурации
• 📋 Инструкции сервера - Отображение инструкций сервера MCP в выходе
• 💡 Действующие ошибки — структурированные сообщения об ошибках с доступными серверами и предложениями по восстановлению

Быстрый старт

1. Установка

или

2. Создать конфигурационный файл

Создайте mcp_servers.json в вашем текущем каталоге или ~/.config/mcp/:

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