Лёгкий CLI для обнаружения и выполнения инструментов с нескольких серверов MCP (Model Context Protocol).

Установка

Пререквизит: uv — менеджер пакетов и среды на Python

Проверьте, что работает:

Краткий справочник

Конфигурация

Создайте mcp.json в вашем каталоге проекта (или ~/.claude/mcp.json для глобальной конфигурации):

Проверьте с помощью mcpl list. Если вы не видите серверы, перезагрузите терминал и запустите mcpl list --refresh.

Добавление новых серверов

Переменные среды используют синтаксис ${VAR} и загружаются из ~/.claude/.env и ./.env.

Открытие конфигураций

MCP Launchpad ищет конфигурационные файлы в следующем порядке:

1. ./mcp.json - конфигурация на уровне проекта
2. ./.claude/mcp.json - конфигурация Claude на уровне проекта
3. ~/.claude/mcp.json — конфигурация пользовательского уровня

Когда найдено несколько конфигурационных файлов, mcpl предлагает выбрать, какие из них использовать. Ваши настройки сохраняются и могут быть изменены позже с помощью mcpl config files --select.

Интеграция агентов

MCP Launchpad работает с любым AI-агентом, который может запускать команды bash (Claude Code, Cursor, Windsurf и др.).

Скопируйте содержимое корня CLAUDE.md в свой собственный CLAUDE.md или AGENTS.md, чтобы научить агента использовать mcpl.

MCP Launchpad

A lightweight CLI for discovering and executing tools from multiple MCP (Model Context Protocol) servers.

Installation

Prerequisite: uv - Python package and environment manager

uv tool install https://github.com/kenneth-liao/mcp-launchpad.git

Verify it works:

mcpl --help

Quick Reference

# Find tools
mcpl search ""                    # Search all tools (returns 5 by default)
mcpl search "" --limit 10         # Get more results
mcpl list                                # List all MCP servers
mcpl list                        # List tools for a server

# Get tool details
mcpl inspect               # Full schema
mcpl inspect   --example   # Schema + example call

# Execute tools
mcpl call   '{}'                        # No arguments
mcpl call   '{"param": "value"}'        # With arguments

# Troubleshooting
mcpl verify                              # Test all server connections
mcpl session status                      # Check daemon status
mcpl session stop                        # Restart daemon (auto-restarts on next call)

Configuration

Create mcp.json in your project directory (or ~/.claude/mcp.json for global config):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

Validate with mcpl list. If you don’t see your servers, restart your terminal and run mcpl list --refresh.

Adding More Servers

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/dir"]
    },
    "github": {
      "command": "uvx",
      "args": ["mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Environment variables use ${VAR} syntax and are loaded from ~/.claude/.env and ./.env.

Config Discovery

MCP Launchpad searches for config files in this order:

1. ./mcp.json - Project-level config
2. ./.claude/mcp.json - Project-level Claude config
3. ~/.claude/mcp.json - User-level config

When multiple config files are found, mcpl prompts you to select which ones to use. Your preferences are saved and can be changed later with mcpl config files --select.

Agent Integration

MCP Launchpad works with any AI agent that can run bash commands (Claude Code, Cursor, Windsurf, etc.).

Copy the root CLAUDE.md contents into your own CLAUDE.md or AGENTS.md to teach your agent how to use mcpl. This can be done at the project level (./CLAUDE.md) or user level (~/.claude/CLAUDE.md).

Important: OAuth Authentication