← Back to directory
P

Protocol Launcher

Community
Framework / SDK
Type-safe one-click links for protocol-based apps

This is a framework for building MCP servers or agents, not a server you connect a client to.

Category
Dev Tools #401 of 438
Stars
★ 140 Very popular
Runtime
Node.js
Credentials
No credential needed
License
MIT
Last commit
33FMRS · D

Based on the repository description and README, Protocol Launcher is an MIT-licensed, ESM-first TypeScript link-generation library focused on one-click protocol app launches, MCP installation links, and configuration imports. The supplied material provides no evidence of callable MCP tools, transport methods, client compatibility, or a server manifest.

Strongest · Documentation 10/20 Weakest · Reliability 3/20

Reliability
3/20
Security and permissions
8/20
Maintenance
8/20
Documentation
10/20
Setup experience
4/20
Why each score
Reliability 3/20
The static material describes a TypeScript library for generating deep links and URL schemes, not an MCP server. There is no server manifest, launch command, MCP initialization/tool-list implementation, or committed test evidence. Handshake behavior, tool correctness, error handling, and dependency control therefore cannot be verified, warranting a substantial deduction.
Security and permissions 8/20
There is no evidence of credential theft, covert exfiltration, or malware; the API key shown is a placeholder. However, generated links can launch applications, install MCP servers, or import provider configuration, and the material shows no confirmation mechanism, permission boundary, data-flow disclosure, or sensitive-data safeguards. A high score is therefore not justified.
Maintenance 8/20
The project states an MIT license and is not archived, and the README displays release and build-related badges. The supplied material does not verify sustained commits, dependency updates, issue response, a security-response channel, or a clear maintenance process, so the score remains moderate-low.
Documentation 10/20
The README provides installation commands for several package managers, subpath imports, API examples, and integration categories. It does not document MCP server configuration, authentication, tool parameters, limits, cost, troubleshooting, or verifiable runtime evidence; full documentation is only linked externally. These gaps justify a substantial deduction.
Setup experience 4/20
Installation as an npm library is clear, but for the stated MCP-server use case there is no server startup method, client configuration, runtime requirement, or working MCP connection flow. The path from runtime preparation to a mainstream-client connection is therefore unclear.

Static review · not runListed 2026-07-30

Read the FMRS scoring method →

Fit and risk

Best for

  • TypeScript developers embedding one-click launch links in websites, documentation, or automation flows
  • Modern Node.js or bundler projects that benefit from on-demand imports and tree-shaking
  • Teams wrapping supported protocol links with type-safe APIs

Not for

  • Users looking for an MCP server whose tools can be connected and called directly
  • Deployments requiring a standalone MCP server, remote transport, or server-side authentication
  • Environments where the target application does not support the relevant protocol or URL scheme

Required permissions

  • The library itself has no explicitly documented system permissions
  • Generated links may ask a target app to open files, projects, settings, or imported configuration; actual permissions depend on the target app and operating system

Risks and side effects

  • Generated links may contain API keys, commands, parameters, or other sensitive configuration; inspect URLs before sharing
  • Opening a link may launch a local app, import settings, or install MCP configuration; use trusted sources and targets
  • The README does not document the complete security boundaries, permission model, or compatibility matrix for each integration

Setup

Before you start

Runtime:Node.js

Install protocol-launcher with pnpm, npm, Yarn, or Bun. Use subpath imports such as protocol-launcher/cursor, protocol-launcher/cherry-studio, and protocol-launcher/vscode for on-demand integrations, or import protocol namespaces from the root entry. See the project documentation for complete API examples.

Check that it works

After installing, import { installMCP } from 'protocol-launcher/cursor' and build a URL; if a well-formed deep link is produced with no errors, the library works.

Troubleshooting

  1. Confirm that the package was installed with the intended package manager and that the import subpath is correct
  2. Confirm that the target app is installed and supports the relevant protocol or URL scheme
  3. Inspect query parameters and Base64 payload encoding, especially for Unicode content
  4. Consult the project documentation for the complete app list and exact API examples
  5. If a link does not open, check whether the operating system allows the browser to launch the target app

Things to try

Once connected, you can ask your AI assistant things like:

  • Generate a deep link with protocol-launcher to install an MCP server in Cursor
  • Use protocol-launcher/vscode to create a URL that opens a file at a given line and column
  • Generate a link with the cherry-studio subpath to import a provider configuration

Use cases

Generate Cursor MCP installation links
Import provider settings into Cherry Studio
Open VS Code files, projects, or settings
Generate URL scheme links for AI, editor, productivity, and system utility apps

Overview

Protocol Launcher is a TypeScript library for generating type-safe deep links and URL scheme links for desktop, mobile, productivity, AI, and developer tools. It can open apps, jump to files or projects, install MCP servers, import provider settings, and encode query strings and Base64 payloads. The repository itself is not documented as an MCP server with a tool list or transport configuration.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

Source revision b7059cedb249 Data synced 2026-10-19 Read the FMRS scoring method