Skip to content
Back to search

mcp-launchpad

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kenneth-liao/mcp-launchpad with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kenneth-liao/mcp-launchpad'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kenneth-liao--mcp-launchpad/badge.svg)](/listings/kenneth-liao--mcp-launchpad)

HTML

<a href="/listings/kenneth-liao--mcp-launchpad"><img src="/api/listings/kenneth-liao--mcp-launchpad/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **Prerequisite**: [uv](https://docs.astral.sh/uv/getting-started/installation/) - Python package and environment manager

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

Verify it works:

mcpl --help

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 506 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Launchpad
  2. A lightweight CLI for discovering and executing tools from multiple MCP (Model Context Protocol) servers.
  3. ![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)
  4. ![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)
  5. ## Installation
  6. > **Prerequisite**: [uv](https://docs.astral.sh/uv/getting-started/installation/) - Python package and environment manager
  7. ```bash
  8. uv tool install https://github.com/kenneth-liao/mcp-launchpad.git
  9. ```
  10. Verify it works:
  11. ```bash
  12. mcpl --help
  13. ```
  14. ## Quick Reference
  15. ```bash
  16. # Find tools
  17. mcpl search "<query>" # Search all tools (returns 5 by default)
  18. mcpl search "<query>" --limit 10 # Get more results
  19. mcpl list # List all MCP servers
  20. mcpl list <server> # List tools for a server
  21. # Get tool details
  22. mcpl inspect <server> <tool> # Full schema
  23. mcpl inspect <server> <tool> --example # Schema + example call
  24. # Execute tools
  25. mcpl call <server> <tool> '{}' # No arguments
  26. mcpl call <server> <tool> '{"param": "value"}' # With arguments
  27. # Troubleshooting
  28. mcpl verify # Test all server connections
  29. mcpl session status # Check daemon status
  30. mcpl session stop # Restart daemon (auto-restarts on next call)
  31. ```
  32. ## Configuration
  33. Create `mcp.json` in your project directory (or `~/.claude/mcp.json` for global config):
  34. ```json
  35. {
  36. "mcpServers": {
  37. "filesystem": {
  38. "command": "npx",
  39. "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/dir"]
  40. }
  41. }
  42. }
  43. ```
  44. Validate with `mcpl list`. If you don't see your servers, restart your terminal and run `mcpl list --refresh`.
  45. ### Adding More Servers
  46. ```json
  47. {
  48. "mcpServers": {
  49. "filesystem": {
  50. "command": "npx",
  51. "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/dir"]
  52. },
  53. "github": {
  54. "command": "uvx",
  55. "args": ["mcp-server-github"],
  56. "env": {
  57. "GITHUB_TOKEN": "${GITHUB_TOKEN}"
  58. }
  59. }
  60. }
  61. }
  62. ```
  63. Environment variables use `${VAR}` syntax and are loaded from `~/.claude/.env` and `./.env`.
  64. ### Config Discovery
  65. MCP Launchpad searches for config files in this order:
  66. 1. `./mcp.json` - Project-level config
  67. 2. `./.claude/mcp.json` - Project-level Claude config
  68. 3. `~/.claude/mcp.json` - User-level config
  69. 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`.
  70. ## Agent Integration
  71. MCP Launchpad works with any AI agent that can run bash commands (Claude Code, Cursor, Windsurf, etc.).
  72. 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`).
  73. > **Important: OAuth Authentication**
  74. >
  75. > Agents cannot complete OAuth flows because they require browser interaction. You must authenticate all OAuth-protected MCP servers **before** agents can use them:
  76. > ```bash
  77. > mcpl auth login <server> # Authenticate a specific server
  78. > mcpl list --refresh # Prompts to authenticate each server that requires OAuth
  79. > mcpl auth status # Verify all servers are authenticated
  80. > ```
  81. **Tip**: Add a section to your `CLAUDE.md` listing your connected MCP servers for better tool discovery.
  82. ### What This Enables
  83. With the instructions in place, your agent can:
  84. - **Search for tools** across all your MCP servers
  85. - **Execute tools** by calling `mcpl` via bash
  86. - **Discover capabilities** dynamically as you add new MCP servers
  87. - **Handle errors** gracefully with built-in troubleshooting guidance
  88. ## Table of Contents
  89. - [Commands](#commands)
  90. - [Session Daemon](#session-daemon)
  91. - [Advanced Topics](#advanced-topics)
  92. - [HTTP Server Configuration](#http-server-configuration)
  93. - [SSE Transport Configuration](#sse-transport-configuration)
  94. - [OAuth Authentication](#oauth-authentication)
  95. - [Environment Variables](#environment-variables)
  96. - [Platform Notes](#platform-notes)
  97. - [Development](#development)
  98. ## Commands
  99. ### `mcpl search <query>`
  100. Search for tools across all configured servers. Returns 5 results by default.
  101. ```bash
  102. mcpl search "sentry errors"
  103. mcpl search "issues" --limit 10 # Get more results
  104. ```
  105. ### `mcpl list [server]`
  106. List configured servers or tools for a specific server.
  107. ```bash
  108. mcpl list # List all servers
  109. mcpl list github # List tools for github server
  110. ```
  111. ### `mcpl call <server> <tool> [arguments]`
  112. Execute a tool on a server.
  113. ```bash
  114. mcpl call github list_issues '{"owner": "acme", "repo": "api"}'
  115. ```
  116. ### `mcpl inspect <server> <tool>`
  117. Get the full schema for a specific tool.
  118. ```bash
  119. mcpl inspect github list_issues --example # Include example call
  120. ```
  121. ### `mcpl session status|stop`
  122. Manage the session daemon.
  123. ```bash
  124. mcpl session status # Show daemon status and connected servers
  125. mcpl session stop # Stop the session daemon
  126. ```
  127. ### `mcpl auth login|logout|status`
  128. Manage OAuth 2.1 authentication for HTTP servers.
  129. ```bash
  130. mcpl auth login notion # Authenticate with an OAuth-protected server
  131. mcpl auth logout notion # Remove stored authentication
  132. mcpl auth logout --all # Clear all stored tokens
  133. mcpl auth status # Show authentication status for all servers
  134. ```
  135. ### `mcpl enable|disable <server>`
  136. Enable or disable servers without modifying the config file.
  137. ```bash
  138. mcpl disable slow-server # Temporarily disable a server
  139. mcpl enable slow-server # Re-enable it
  140. ```
  141. ### `mcpl config`
  142. Show the current configuration and loaded servers.
  143. ```bash
  144. mcpl config
  145. ```
  146. ### `mcpl config files`
  147. Manage which config files are active when multiple are available.
  148. ```bash
  149. mcpl config files # View config files and their status
  150. mcpl config files --select # Interactive selection prompt
  151. mcpl config files --activate 1 # Activate config by number
  152. mcpl config files --deactivate 2 # Deactivate config by number
  153. mcpl config files --all # Activate all discovered configs
  154. mcpl config files --reset # Clear preferences (re-prompts on next run)
  155. ```
  156. ### `mcpl verify`
  157. Test that all configured servers can connect and respond.
  158. ```bash
  159. mcpl verify
  160. ```
  161. ### JSON Mode
  162. Add `--json` for machine-readable output:
  163. ```bash
  164. mcpl --json search "github"
  165. mcpl --json call github list_repos '{}'
  166. ```
  167. ## Session Daemon
  168. 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`.
  169. ### Automatic Cleanup
  170. | Environment | Cleanup Trigger |
  171. |-------------|-----------------|
  172. | Regular terminal | Parent terminal process exits |
  173. | VS Code / Claude Code | IDE session ends (detected via VS Code socket) |
  174. | Any environment | Idle timeout (default: 1 hour of no activity) |
  175. | Manual | `mcpl session stop` command |
  176. ### Troubleshooting
  177. ```bash
  178. mcpl session status # Check daemon status
  179. mcpl session stop # Stop the daemon manually
  180. mcpl call github list_repos '{}' --no-daemon # Bypass daemon for debugging
  181. ```
  182. If you encounter persistent issues, stopping and restarting the daemon usually resolves them.
  183. ## Advanced Topics
  184. ### HTTP Server Configuration
  185. HTTP servers connect to remote MCP endpoints over HTTP.
  186. ```json
  187. {
  188. "mcpServers": {
  189. "remote-api": {
  190. "type": "http",
  191. "url": "https://api.example.com/mcp",
  192. "headers": {
  193. "Authorization": "Bearer ${API_TOKEN}"
  194. }
  195. }
  196. }
  197. }
  198. ```
  199. | Field | Required | Description |
  200. |-------|----------|-------------|
  201. | `type` | Yes | Must be `"http"` |
  202. | `url` | Yes | Full URL to the MCP endpoint |
  203. | `headers` | No | HTTP headers (supports `${VAR}` syntax) |
  204. For OAuth-protected servers, see [OAuth Authentication](#oauth-authentication).
  205. ### SSE Transport Configuration
  206. Some legacy MCP servers use Server-Sent Events (SSE) instead of the newer Streamable HTTP transport:
  207. ```json
  208. {
  209. "mcpServers": {
  210. "legacy-server": {
  211. "type": "sse",
  212. "url": "https://legacy.example.com/sse",
  213. "headers": {
  214. "Authorization": "Bearer ${API_TOKEN}"
  215. }
  216. }
  217. }
  218. }
  219. ```
  220. > **Note:** SSE transport is provided for compatibility with older MCP servers. New servers should use standard HTTP transport.
  221. ### OAuth Authentication
  222. 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.
  223. #### Quick Start
  224. When you connect to a server that requires authentication, mcpl will prompt you:
  225. ```bash
  226. $ mcpl list notion --refresh
  227. Server 'notion' requires OAuth authentication.
  228. Would you like to authenticate now? [Y/n]
  229. ```
  230. Or authenticate proactively:
  231. ```bash
  232. mcpl auth login notion
  233. ```
  234. This opens your browser for authorization. After you approve, tokens are stored securely.
  235. #### Commands
  236. | Command | Description |
  237. |---------|-------------|
  238. | `mcpl auth login <server>` | Authenticate with an OAuth-protected server |
  239. | `mcpl auth logout <server>` | Remove stored authentication |
  240. | `mcpl auth logout --all` | Clear all stored tokens |
  241. | `mcpl auth status [server]` | Show authentication status |
  242. #### Configuration
  243. For servers that require pre-registered OAuth credentials:
  244. ```json
  245. {
  246. "mcpServers": {
  247. "notion": {
  248. "type": "http",
  249. "url": "https://mcp.notion.com/mcp",
  250. "oauth_client_id": "${NOTION_CLIENT_ID}",
  251. "oauth_client_secret": "${NOTION_CLIENT_SECRET}",
  252. "oauth_scopes": ["read", "write"]
  253. }
  254. }
  255. }
  256. ```
  257. Tokens are encrypted and stored locally in `~/.cache/mcp-launchpad/oauth/` using your system's keyring.
  258. #### Troubleshooting
  259. | Issue | Solution |
  260. |-------|----------|
  261. | "Server requires OAuth authentication" | Run `mcpl auth login <server>` |
  262. | Token expired | Run `mcpl auth login <server> --force` |
  263. | Browser doesn't open | Copy the URL from terminal and open manually |
  264. | "Invalid client" errors | Check `oauth_client_id` and `oauth_client_secret` |
  265. | Keyring warnings | Using fallback encryption (still secure) |
  266. | "Metadata fetch failed" | Configure credentials manually in `mcp.json` |
  267. <details>
  268. <summary><strong>Advanced: Login Options & Security Details</strong></summary>
  269. #### Login Options
  270. ```bash
  271. mcpl auth login notion # Basic authentication
  272. mcpl auth login figma --scope "read write" # Request specific scopes
  273. mcpl auth login custom --force # Re-authenticate (replace existing tokens)
  274. mcpl auth login server --client-id "id" # Specific client ID
  275. # Secure secret input (recommended)
  276. echo "secret" | mcpl auth login server --client-secret-stdin
  277. # Or via environment variable
  278. export MCPL_CLIENT_SECRET="secret"
  279. ```
  280. Options:
  281. - `--scope TEXT` - Additional OAuth scopes to request
  282. - `--force` - Force re-authentication even if already logged in
  283. - `--client-id TEXT` - Use a specific OAuth client ID
  284. - `--client-secret-stdin` - Read client secret from stdin
  285. - `--timeout INTEGER` - Browser callback timeout (default: 120 seconds)
  286. #### Client Registration Strategy
  287. MCP Launchpad uses a flexible registration approach:
  288. 1. **Config file** - Pre-configured credentials in `mcp.json`
  289. 2. **DCR** - Dynamic Client Registration if supported by the server
  290. 3. **Interactive** - Manual input as fallback
  291. This approach is more flexible than Claude Code, which requires DCR support.
  292. #### Server Compatibility
  293. MCP Launchpad supports OAuth servers with varying levels of standards compliance:
  294. - **RFC 9728** - MCP-native OAuth servers with `/.well-known/oauth-authorization-server` at the MCP resource path
  295. - **RFC 8414** - Standard OAuth servers with `/.well-known/oauth-authorization-server` at the server root
  296. - **Non-compliant** - Servers without metadata discovery (falls back to manual configuration)
  297. #### Security Features
  298. - **Fernet encryption** (AES-128-CBC + HMAC) for tokens at rest
  299. - **OS keyring integration** (Keychain on macOS, libsecret on Linux, DPAPI on Windows)
  300. - **PKCE with S256** (RFC 7636) for secure authorization
  301. - **Token revocation** on logout (RFC 7009)
  302. - **HTTPS enforcement** for all OAuth endpoints
  303. > **Note:** If OS keyring is unavailable, a warning will be displayed and tokens will use fallback encryption.
  304. </details>
  305. ### Environment Variables
  306. Common settings you may need to configure:
  307. | Variable | Default | Description |
  308. |----------|---------|-------------|
  309. | `MCPL_CONFIG_FILES` | (auto) | Comma-separated list of config files (overrides discovery) |
  310. | `MCPL_CONNECTION_TIMEOUT` | `45` | Server connection timeout in seconds |
  311. | `MCPL_IDLE_TIMEOUT` | `3600` | Daemon idle timeout (0 to disable) |
  312. <details>
  313. <summary><strong>All Environment Variables</strong></summary>
  314. #### Connection Settings
  315. | Variable | Default | Description |
  316. |----------|---------|-------------|
  317. | `MCPL_CONNECTION_TIMEOUT` | `45` | MCP server connection/initialization timeout (seconds) |
  318. | `MCPL_RECONNECT_DELAY` | `5` | Delay before retrying a failed server connection (seconds) |
  319. | `MCPL_MAX_RECONNECT_ATTEMPTS` | `3` | Max reconnection attempts before giving up |
  320. #### Daemon Settings
  321. | Variable | Default | Description |
  322. |----------|---------|-------------|
  323. | `MCPL_DAEMON_START_TIMEOUT` | `30` | Max time to wait for daemon startup (seconds) |
  324. | `MCPL_DAEMON_CONNECT_RETRY_DELAY` | `0.2` | Delay between connection attempts to daemon (seconds) |
  325. | `MCPL_PARENT_CHECK_INTERVAL` | `5` | How often daemon checks if parent process is alive (seconds) |
  326. #### IDE/Session Settings
  327. | Variable | Default | Description |
  328. |----------|---------|-------------|
  329. | `MCPL_IDLE_TIMEOUT` | `3600` | Shut down daemon after this many seconds of inactivity (0 to disable) |
  330. | `MCPL_IDE_ANCHOR_CHECK_INTERVAL` | `10` | How often to check if IDE session is still active (seconds) |
  331. | `MCPL_SESSION_ID` | (auto) | Override the session ID (for testing or advanced multi-session setups) |
  332. </details>
  333. ## Platform Notes
  334. ### Windows (Experimental)
  335. Windows support uses named pipes for IPC communication. While functional, it may have limitations compared to Unix sockets on macOS/Linux.
  336. If you encounter issues:
  337. 1. Use `--no-daemon` flag to bypass the session daemon
  338. 2. Set `MCPL_SESSION_ID` explicitly if session detection is unreliable
  339. 3. Report issues at https://github.com/kenneth-liao/mcp-launchpad/issues
  340. ## Development
  341. Requires Python 3.13+
  342. ```bash
  343. git clone https://github.com/kenneth-liao/mcp-launchpad.git
  344. cd mcp-launchpad
  345. uv sync --all-extras
  346. # Run tests
  347. uv run pytest
  348. # Run tests with coverage
  349. uv run pytest --cov=mcp_launchpad
  350. # Type checking
  351. uv run mypy mcp_launchpad
  352. ```
  353. ## Features
  354. - **Unified Tool Discovery** - Search across all configured MCP servers with BM25, regex, or exact matching
  355. - **Persistent Connections** - Session daemon maintains server connections for faster repeated calls
  356. - **HTTP & Stdio Support** - Connect to both local process-based servers and remote HTTP/Streamable MCP servers
  357. - **SSE Transport Support** - Connect to legacy MCP servers using Server-Sent Events
  358. - **Multi-Config Management** - Use multiple config files simultaneously with interactive selection
  359. - **OAuth 2.1 Authentication** - Secure authentication for OAuth-protected MCP servers (Notion, Figma, etc.)
  360. - **Auto-Configuration** - Reads from `./mcp.json` (project-level) or `~/.claude/mcp.json` (user-level)
  361. - **Cross-Platform** - Works on macOS, Linux, and Windows (experimental)
  362. - **JSON Mode** - Machine-readable output for scripting and automation
  363. ## License
  364. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.