在上一篇文章中，我们介绍了 Protocol Launcher 如何通过类型安全的方式生成应用唤起链接。今天，我们将深入探讨该系列的第一站：Cherry Studio。
Cherry Studio 协议
Cherry Studio 是一款极其强大的桌面级 AI 客户端，它支持接入多种 AI 模型提供商（如 OpenAI, Anthropic, DeepSeek 等），并且完美支持 MCP (Model Context Protocol) 协议。
然而，手动在 Cherry Studio 中配置一个 MCP 服务器或 AI 提供商往往需要填写大量的表单：名称、描述、命令、参数、环境变量、Base URL… 稍有不慎就会配置失败。
现在，通过 Protocol Launcher，你可以将这些复杂的配置封装成一个简单的 URL 链接，实现“一键安装”。
核心能力：installMCP 与 installProvider
Protocol Launcher 为 Cherry Studio 专门提供了 protocol-launcher/cherry-studio 模块，支持以下核心功能：
快速上手
首先，确保你的项目中已安装：
npm install protocol-launcher
在代码中你可以根据场景选择两种导入方式：
- 按需加载（通过子路径导入），支持 Tree Shaking，体积更小；
- 全量导入（从根包导入），写法更简单，但会引入所有已支持应用的逻辑。
// ✅ 推荐：按需加载 Cherry Studio 模块
import { installMCP, installProvider } from 'protocol-launcher/cherry-studio'
// 也可以从根包导入，但会包含所有应用模块
// import { cherryStudio } from 'protocol-launcher'
场景一：安装 STDIO 类型的 MCP 服务
如果你开发了一个本地运行的 MCP 服务（例如基于 npx 运行的服务），可以使用以下代码生成安装链接。通过添加 logoUrl、description 和 tags 等参数，用户在安装时能看到专业且信任感强的品牌展示：
import { installMCP } from 'protocol-launcher/cherry-studio'
const url = installMCP({
name: 'server-everything',
description: '这个 MCP 服务器尝试运行 MCP 协议的所有特性。它不仅是一个有用的服务器，更是 MCP 客户端构建者的测试利器。',
type: 'stdio',
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-everything'],
registryUrl: 'https://registry.npmmirror.com',
provider: 'Anthropic',
providerUrl: 'https://modelcontextprotocol.io/',
logoUrl: 'https://avatars.githubusercontent.com/u/182288589?s=200&v=4',
})
场景二：批量安装多个 MCP 服务
对于企业级应用，你可能需要引导用户一次性安装多个工具集。通过完善 tags 和 providerUrl，可以实现更好的分类展示和快捷跳转：
import { installMCP } from 'protocol-launcher/cherry-studio'
const url = installMCP({
mcpServers: {
'qcc-company-basic': {
name: '企查查企业信息 MCP',
description: '企业信息 MCP 提供全面的企业画像分析与企业信息洞察服务，助您快速验证企业真实性、评估其稳定性和发展轨迹，为您的商业行动提供坚实的数据支撑。',
type: 'streamableHttp',
baseUrl: 'https://mcp.qcc.com/basic/stream',
headers: {
Authorization: 'YOUR_TOKEN',
},
provider: 'QCC',
providerUrl: 'https://openapi.qcc.com/mcpTools?service=basic',
logoUrl: 'https://openapi.qcc.com/favicon.ico',
tags: ['company-basic', '企业信息'],
timeout: 30,
},
'qcc-company-risk': {
name: '企查查风险信息 MCP',
description: '风险信息 MCP 提供全面的企业风险透视扫描能力，可识别企业在司法、行政、经营等方面的信用与合规隐患，助您精准评估合作对象的可靠性，有效规避商业陷阱与连带风险。',
type: 'sse',
baseUrl: 'https://mcp.qcc.com/basic/sse',
headers: {
Authorization: 'YOUR_TOKEN',
},
provider: 'QCC',
providerUrl: 'https://openapi.qcc.com/mcpTools?service=risk',
logoUrl: 'https://openapi.qcc.com/favicon.ico',
tags: ['company-risk', '风险信息'],
timeout: 30,
}
}
})
场景三：配置 AI 提供商
除了 MCP，你还可以引导用户配置模型供应商。例如配置 DeepSeek：
import { installProvider } from 'protocol-launcher/cherry-studio'
const url = installProvider({
id: 'deepseek',
baseUrl: 'https://api.deepseek.com',
apiKey: 'sk-xxxxxx'
})
为什么选择 Protocol Launcher？
极佳的视觉呈现：通过填写 logoUrl、description 和 tags，用户在 Cherry Studio 中看到的不再是枯燥的代码，而是信息完善、带有官方品牌标识、功能描述清晰的配置卡片。这种专业感能显著提升用户的信任度和使用意愿。
图：完善参数后的 Cherry Studio MCP 卡片展示，专业且信任感强
增强的交互性：providerUrl 等参数可以在应用中生成快捷按钮，方便用户一键跳转到官网或文档中心。
类型安全：在编写配置时，IDE 会自动提示哪些字段是必填的（例如 stdio 必须有 command，而 sse 必须有 baseUrl）。
自动编码与 Unicode 支持：你不再需要手动调用 encodeURIComponent，Protocol Launcher 会自动处理所有的特殊字符。更重要的是，它完美支持中日韩（CJK）文字，无论是中文描述、日文标签还是韩文提供商名称，都能确保在唤起应用时不会出现乱码。
极致的按需加载 (Tree Shaking)：Protocol Launcher 采用了模块化设计，支持按需加载以最小化包体积：
- 推荐方式：使用子路径导入（如 import { … } from 'protocol-launcher/cherry-studio'），这样构建工具只会打包与 Cherry Studio 相关的代码，不会引入其他无关应用的逻辑。
- 全量方式：如果你在编写简单的脚本或演示，也可以从根包导入（如 import { cherryStudio } from 'protocol-launcher'），但这会包含库中所有支持的应用模块。建议生产环境始终使用按需加载。
结语
通过 Protocol Launcher，开发者可以极大降低用户使用 MCP 服务的门槛。无论是在文档中提供一个“添加到 Cherry Studio”的按钮，还是在自动化脚本中分发配置，它都是最优雅的选择。
🔗 相关链接
- Protocol Launcher 官网: https://protocol-launcher.huayi-data.com/
- Cherry Studio 模块文档: Cherry Studio | Protocol Launcher
