複数のMCP(Model Context Protocol)サーバーからツールを発見・実行するための軽量CLIです。

設置

前提条件: 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は、bashコマンドを実行できるあらゆるAIエージェント(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