MCP Launchpad 7d9de8ee

MCP开发工具

提供方 kenneth-liao

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCursorWindsurf
查看接入方式

MCP Launchpad是一个轻量级CLI工具,用于发现和执行来自多个MCP(Model Context Protocol)服务器的工具,适用于开发效率和自动化场景。

一句话选型结论

按资料字段整理

MCP Launchpad 7d9de8ee 属于开发工具类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude、Cursor、Windsurf,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 207 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

CLI工具Python本地部署开发效率自动化MCP协议工具发现

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run pytest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Launchpad 7d9de8ee当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方kenneth-liao上游标注的维护方 kenneth-liao
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.7 KB
来自项目仓库与上游目录的原文,未做删改

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```bash
uv tool install https://github.com/kenneth-liao/mcp-launchpad.git


Verify it works:```bash
mcpl --help

Quick Reference```bash

Find tools

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

Get tool details

mcpl inspect <server> <tool> # Full schema
mcpl inspect <server> <tool> --example # Schema + example call

Execute tools

mcpl call <server> <tool> '{}' # No arguments
mcpl call <server> <tool> '{"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):```json
{
  &quot;mcpServers&quot;: {
    &quot;filesystem&quot;: {
      &quot;command&quot;: &quot;npx&quot;,
      &quot;args&quot;: [&quot;-y&quot;, &quot;@anthropic/mcp-server-filesystem&quot;, &quot;/path/to/allowed/dir&quot;]
    }
  }
}

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

Adding More Servers```json

{
"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`).

&gt; **Important: OAuth Authentication**
&gt;
&gt; Agents cannot complete OAuth flows because they require browser interaction. You must authenticate all OAuth-protected MCP servers **before** agents can use them:
&gt;```bash
&gt; mcpl auth login &lt;server&gt;    # Authenticate a specific server
&gt; mcpl list --refresh         # Prompts to authenticate each server that requires OAuth
&gt; mcpl auth status            # Verify all servers are authenticated
&gt; ```

**Tip**: Add a section to your `CLAUDE.md` listing your connected MCP servers for better tool discovery.

### What This Enables

With the instructions in place, your agent can:

- **Search for tools** across all your MCP servers
- **Execute tools** by calling `mcpl` via bash
- **Discover capabilities** dynamically as you add new MCP servers
- **Handle errors** gracefully with built-in troubleshooting guidance

## Table of Contents

- Commands
- Session Daemon
- Advanced Topics
  - HTTP Server Configuration
  - SSE Transport Configuration
  - OAuth Authentication
  - Environment Variables
- Platform Notes
- Development

## Commands

### `mcpl search `

Search for tools across all configured servers. Returns 5 results by default.```bash
mcpl search &quot;sentry errors&quot;
mcpl search &quot;issues&quot; --limit 10   # Get more results

mcpl list [server]

List configured servers or tools for a specific server.```bash
mcpl list # List all servers
mcpl list github # List tools for github server


### `mcpl call   [arguments]`

Execute a tool on a server.```bash
mcpl call github list_issues &#x27;{&quot;owner&quot;: &quot;acme&quot;, &quot;repo&quot;: &quot;api&quot;}&#x27;

mcpl inspect

Get the full schema for a specific tool.```bash
mcpl inspect github list_issues --example # Include example call


### `mcpl session status|stop`

Manage the session daemon.```bash
mcpl session status   # Show daemon status and connected servers
mcpl session stop     # Stop the session daemon

mcpl auth login · logout · status

Manage OAuth 2.1 authentication for HTTP servers.```bash
mcpl auth login notion # Authenticate with an OAuth-protected server
mcpl auth logout notion # Remove stored authentication
mcpl auth logout --all # Clear all stored tokens
mcpl auth status # Show authentication status for all servers


### `mcpl enable|disable `

Enable or disable servers without modifying the config file.```bash
mcpl disable slow-server    # Temporarily disable a server
mcpl enable slow-server     # Re-enable it

mcpl config

Show the current configuration and loaded servers.```bash
mcpl config


### `mcpl config files`

Manage which config files are active when multiple are available.```bash
mcpl config files                    # View config files and their status
mcpl config files --select           # Interactive selection prompt
mcpl config files --activate 1       # Activate config by number
mcpl config files --deactivate 2     # Deactivate config by number
mcpl config files --all              # Activate all discovered configs
mcpl config files --reset            # Clear preferences (re-prompts on next run)

mcpl verify

Test that all configured servers can connect and respond.```bash
mcpl verify


### JSON Mode

Add `--json` for machine-readable output:```bash
mcpl --json search &quot;github&quot;
mcpl --json call github list_repos &#x27;{}&#x27;

Session Daemon

MCP Launchpad uses a session daemon to maintain persistent connections to MCP servers, improving performance for repeated calls. The daemon starts automatically on first mcpl call.

Automatic Cleanup

Environment Cleanup Trigger
Regular terminal Parent terminal process exits
VS Code / Claude Code IDE session ends (detected via VS Code socket)
Any environment Idle timeout (default: 1 hour of no activity)
Manual mcpl session stop command

Troubleshooting```bash

mcpl session status # Check daemon status
mcpl session stop # Stop the daemon manually
mcpl call github list_repos '{}' --no-daemon # Bypass daemon for debugging


If you encounter persistent issues, stopping and restarting the daemon usually resolves them.

## Advanced Topics

### HTTP Server Configuration

HTTP servers connect to remote MCP endpoints over HTTP.```json
{
  &quot;mcpServers&quot;: {
    &quot;remote-api&quot;: {
      &quot;type&quot;: &quot;http&quot;,
      &quot;url&quot;: &quot;https://api.example.com/mcp&quot;,
      &quot;headers&quot;: {
        &quot;Authorization&quot;: &quot;Bearer ${API_TOKEN}&quot;
      }
    }
  }
}
Field Required Description
type Yes Must be &quot;http&quot;
url Yes Full URL to the MCP endpoint
headers No HTTP headers (supports ${VAR} syntax)

For OAuth-protected servers, see OAuth Authentication.

SSE Transport Configuration

Some legacy MCP servers use Server-Sent Events (SSE) instead of the newer Streamable HTTP transport:```json
{
"mcpServers": {
"legacy-server": {
"type": "sse",
"url": "https://legacy.example.com/sse",
"headers": {
"Authorization": "Bearer ${API_TOKEN}"
}
}
}
}


&gt; **Note:** SSE transport is provided for compatibility with older MCP servers. New servers should use standard HTTP transport.

### OAuth Authentication

Some remote MCP servers (like Notion, Figma, and other cloud services) require OAuth authentication. MCP Launchpad handles this securely using OAuth 2.1 with PKCE.

#### Quick Start

When you connect to a server that requires authentication, mcpl will prompt you:```bash
$ mcpl list notion --refresh
Server &#x27;notion&#x27; requires OAuth authentication.
Would you like to authenticate now? [Y/n]

Or authenticate proactively:```bash
mcpl auth login notion


This opens your browser for authorization. After you approve, tokens are stored securely.

#### Commands

| Command | Description |
|---------|-------------|
| `mcpl auth login ` | Authenticate with an OAuth-protected server |
| `mcpl auth logout ` | Remove stored authentication |
| `mcpl auth logout --all` | Clear all stored tokens |
| `mcpl auth status [server]` | Show authentication status |

#### Configuration

For servers that require pre-registered OAuth credentials:```json
{
  &quot;mcpServers&quot;: {
    &quot;notion&quot;: {
      &quot;type&quot;: &quot;http&quot;,
      &quot;url&quot;: &quot;https://mcp.notion.com/mcp&quot;,
      &quot;oauth_client_id&quot;: &quot;${NOTION_CLIENT_ID}&quot;,
      &quot;oauth_client_secret&quot;: &quot;${NOTION_CLIENT_SECRET}&quot;,
      &quot;oauth_scopes&quot;: [&quot;read&quot;, &quot;write&quot;]
    }
  }
}

Tokens are encrypted and stored locally in ~/.cache/mcp-launchpad/oauth/ using your system's keyring.

Troubleshooting

Issue Solution
"Server requires OAuth authentication" Run mcpl auth login
Token expired Run mcpl auth login --force
Browser doesn't open Copy the URL from terminal and open manually
"Invalid client" errors Check oauth_client_id and oauth_client_secret
Keyring warnings Using fallback encryption (still secure)
"Metadata fetch failed" Configure credentials manually in mcp.json

Advanced: Login Options & Security Details

Login Options```bash

mcpl auth login notion # Basic authentication
mcpl auth login figma --scope "read write" # Request specific scopes
mcpl auth login custom --force # Re-authenticate (replace existing tokens)
mcpl auth login server --client-id "id" # Specific client ID

Secure secret input (recommended)

echo "secret" | mcpl auth login server --client-secret-stdin

Or via environment variable

export MCPL_CLIENT_SECRET="secret"


Options:
- `--scope TEXT` - Additional OAuth scopes to request
- `--force` - Force re-authentication even if already logged in
- `--client-id TEXT` - Use a specific OAuth client ID
- `--client-secret-stdin` - Read client secret from stdin
- `--timeout INTEGER` - Browser callback timeout (default: 120 seconds)

#### Client Registration Strategy

MCP Launchpad uses a flexible registration approach:

1. **Config file** - Pre-configured credentials in `mcp.json`
2. **DCR** - Dynamic Client Registration if supported by the server
3. **Interactive** - Manual input as fallback

This approach is more flexible than Claude Code, which requires DCR support.

#### Server Compatibility

MCP Launchpad supports OAuth servers with varying levels of standards compliance:

- **RFC 9728** - MCP-native OAuth servers with `/.well-known/oauth-authorization-server` at the MCP resource path
- **RFC 8414** - Standard OAuth servers with `/.well-known/oauth-authorization-server` at the server root
- **Non-compliant** - Servers without metadata discovery (falls back to manual configuration)

#### Security Features

- **Fernet encryption** (AES-128-CBC + HMAC) for tokens at rest
- **OS keyring integration** (Keychain on macOS, libsecret on Linux, DPAPI on Windows)
- **PKCE with S256** (RFC 7636) for secure authorization
- **Token revocation** on logout (RFC 7009)
- **HTTPS enforcement** for all OAuth endpoints

&gt; **Note:** If OS keyring is unavailable, a warning will be displayed and tokens will use fallback encryption.

### Environment Variables

Common settings you may need to configure:

| Variable | Default | Description |
|----------|---------|-------------|
| `MCPL_CONFIG_FILES` | (auto) | Comma-separated list of config files (overrides discovery) |
| `MCPL_CONNECTION_TIMEOUT` | `45` | Server connection timeout in seconds |
| `MCPL_IDLE_TIMEOUT` | `3600` | Daemon idle timeout (0 to disable) |

All Environment Variables

#### Connection Settings

| Variable | Default | Description |
|----------|---------|-------------|
| `MCPL_CONNECTION_TIMEOUT` | `45` | MCP server connection/initialization timeout (seconds) |
| `MCPL_RECONNECT_DELAY` | `5` | Delay before retrying a failed server connection (seconds) |
| `MCPL_MAX_RECONNECT_ATTEMPTS` | `3` | Max reconnection attempts before giving up |

#### Daemon Settings

| Variable | Default | Description |
|----------|---------|-------------|
| `MCPL_DAEMON_START_TIMEOUT` | `30` | Max time to wait for daemon startup (seconds) |
| `MCPL_DAEMON_CONNECT_RETRY_DELAY` | `0.2` | Delay between connection attempts to daemon (seconds) |
| `MCPL_PARENT_CHECK_INTERVAL` | `5` | How often daemon checks if parent process is alive (seconds) |

#### IDE/Session Settings

| Variable | Default | Description |
|----------|---------|-------------|
| `MCPL_IDLE_TIMEOUT` | `3600` | Shut down daemon after this many seconds of inactivity (0 to disable) |
| `MCPL_IDE_ANCHOR_CHECK_INTERVAL` | `10` | How often to check if IDE session is still active (seconds) |
| `MCPL_SESSION_ID` | (auto) | Override the session ID (for testing or advanced multi-session setups) |

## Platform Notes

### Windows (Experimental)

Windows support uses named pipes for IPC communication. While functional, it may have limitations compared to Unix sockets on macOS/Linux.

If you encounter issues:

1. Use `--no-daemon` flag to bypass the session daemon
2. Set `MCPL_SESSION_ID` explicitly if session detection is unreliable
3. Report issues at https://github.com/kenneth-liao/mcp-launchpad/issues

## Development

Requires Python 3.13+```bash
git clone https://github.com/kenneth-liao/mcp-launchpad.git
cd mcp-launchpad
uv sync --all-extras

# Run tests
uv run pytest

# Run tests with coverage
uv run pytest --cov=mcp_launchpad

# Type checking
uv run mypy mcp_launchpad

Features

  • Unified Tool Discovery - Search across all configured MCP servers with BM25, regex, or exact matching
  • Persistent Connections - Session daemon maintains server connections for faster repeated calls
  • HTTP & Stdio Support - Connect to both local process-based servers and remote HTTP/Streamable MCP servers
  • SSE Transport Support - Connect to legacy MCP servers using Server-Sent Events
  • Multi-Config Management - Use multiple config files simultaneously with interactive selection
  • OAuth 2.1 Authentication - Secure authentication for OAuth-protected MCP servers (Notion, Figma, etc.)
  • Auto-Configuration - Reads from ./mcp.json (project-level) or ~/.claude/mcp.json (user-level)
  • Cross-Platform - Works on macOS, Linux, and Windows (experimental)
  • JSON Mode - Machine-readable output for scripting and automation

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Launchpad 7d9de8ee 怎么安装?

在客户端按下面的安装命令接入:uv run pytest。装完在客户端配置里引用同一个包或端点。

MCP Launchpad 7d9de8ee 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Launchpad 7d9de8ee 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Launchpad 7d9de8ee 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

MCP Launchpad 7d9de8ee 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Launchpad 7d9de8ee 能提供哪些能力?

资料显示能力标签包括 命令行工具、工具发现、Python、Claude、开发工具。具体工具清单以官方文档为准。

MCP Launchpad 7d9de8ee 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

MCP Launchpad 7d9de8ee 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。