convez.ai
MCP ServerAutomaçãoIntermediário
zhensherlock

Protocol Launcher

zhensherlock/protocol-launcher

URLs de protocolo type-safe para launch, install e config de apps

Ver no GitHub
BomPluginScore · de 0 a 100

Gerador type-safe de deep links para aplicações baseadas em protocolos. Permite criar URLs de um clique para abrir, instalar e configurar ferramentas como Cursor, Cherry Studio e VS Code de forma segura e tipada.

Instalação

$npx convez-ai zhensherlock/protocol-launcher

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
141
Forks
2
Acompanhando
1
Saúde
85%
Último commit
há 1 dia
Versão
@protocol-launcher/protocol-launcher@1.29.0
Issues abertas
9
Contribuidores
2

Casos de uso

  • Instalar MCP servers em aplicações como Cursor e Cherry Studio
  • Gerar links para abrir arquivos em VS Code com linha e coluna específicas
  • Configurar provedores e integrar aplicações produtivas via deep links
  • Automatizar fluxos de inicialização de ferramentas de desenvolvimento

Veredito

Ferramenta prática e bem-estruturada para automação de deep links em ecossistema de AI/dev tools. Type-safety e zero dependências externas são pontos fortes; uso varia conforme necessidade de integração com protocolo específico.

README

A tradução para o português deste README ainda está na fila.

Protocol Launcher

One-click launch URL generator for protocol-based apps.

protocol-launcher helps you generate typed deep links and URL scheme links for desktop, mobile, productivity, AI, and developer tools. Use it to open apps, jump to files or projects, install MCP servers, import provider settings, and create safe one-click launch links for websites, docs, CLIs, and automation flows.

Why Protocol Launcher?

  • Type-safe builders for supported protocol payloads.
  • On-demand imports such as protocol-launcher/vscode and protocol-launcher/cherry-studio.
  • Safe query-string and base64 payload encoding, including Unicode payloads.
  • Broad protocol coverage across AI tools, editors, productivity apps, native macOS apps, and utilities.
  • ESM-first output for Node.js and modern bundlers.
  • Zero third-party runtime dependencies.

Installation

pnpm add protocol-launcher
npm install protocol-launcher
yarn add protocol-launcher
bun add protocol-launcher

Usage

On-Demand Import

Use direct subpath imports when you only need one app integration.

import { installMCP } from 'protocol-launcher/cursor'

const url = installMCP({
  name: 'server-everything',
  type: 'stdio',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-everything'],
  openInNewWindow: true,
})
import { installProvider } from 'protocol-launcher/cherry-studio'

const url = installProvider({
  id: 'new-api',
  baseUrl: 'https://open.cherryin.ai',
  apiKey: 'sk-xxxx',
})
import { openFile } from 'protocol-launcher/vscode'

const url = openFile({
  path: '/code/protocol-launcher/README.md',
  line: 1,
  column: 1,
})

Full Import

The root entry exports each protocol as a namespace.

import { cherryStudio, cursor, vscode } from 'protocol-launcher'

const settingsUrl = vscode.openSettings({
  path: 'terminal.integrated.suggest.enabled',
})

const folderUrl = cursor.openFolder({
  path: '/code/protocol-launcher',
})

const providerUrl = cherryStudio.installProvider({
  id: 'openai',
  baseUrl: 'https://api.openai.com/v1',
  apiKey: 'sk-xxxx',
})

Prefer subpath imports for production bundles when possible.

Popular Integrations

import { openThread } from 'protocol-launcher/codex'
import { installMCP } from 'protocol-launcher/cursor'
import { open } from 'protocol-launcher/telegram'
import { openSettings } from 'protocol-launcher/vscode'

Examples of supported app categories:

  • AI and coding tools: antigravity, cherry-studio, code-buddy, codex, cursor, kiro, lingma, opencode, qoder, trae, vscode, windsurf, zed
  • Editors and IDEs: bbedit, code-runner, goland, idea, macvim, nova, phpstorm, pycharm, rustrover, textastic, textmate, webstorm, xcode
  • Productivity and notes: agenda, bear, craft, drafts, evernote, fsnotes, obsidian, things, todoist, trello, ulysses, working-copy
  • Platform and utilities: app-store, apple-map, macos, microsoft-edge, shortcuts, steam, telegram, thunder, wemeet

See the documentation site for the full app list and exact API examples.

Docs

Full guides and examples: https://zhensherlock.github.io/protocol-launcher/

Contributing

Feel free to dive in! Open an issue or submit PRs.

Standard Readme follows the Contributor Covenant Code of Conduct.

Contributors

This project exists thanks to all the people who contribute.

License

MIT © MichaelSun

Ver o original no GitHub

Bom para

Relacionados