企业官网建设流程全解析

• 音视频
• 桌面应用
• 人工智能
• MCP 服务
• AI Agent

Palmier Pro 是一款为 AI 时代打造的 macOS 原生视频编辑器，其核心特性之一是内置的 MCP（Model Context Protocol）服务器：只要应用处于打开状态，它就在http://127.0.0.1:19789/mcp暴露一个 HTTP MCP 端点，让外部 Agent 通过标准工具调用直接读取时间线、剪辑片段、生成素材并导出项目。本文将基于官方阿拉伯语文档与仓库源码，完整讲解该 MCP 服务器的连接配置、四类主流客户端的接入方式、底层实现原理、FAQ 中的授权与平台信息，帮助你在 Claude Code、Codex、Cursor、Claude Desktop 中快速建立与 Palmier Pro 的协同工作流。

一、产品定位：为 AI 协作而生的 Swift 原生视频编辑器

官方文档明确将 Palmier Pro 定位为「为 AI 时代设计的视频编辑器」（محرر فيديو مصمم لعصر الذكاء الاصطناعي），其三大支柱如下：

• Swift 原生编辑器：从零开始使用 Swift 编写（源码集中在 Sources/PalmierPro），以 Adobe Premiere Pro 为体验标杆，但针对现代 AI 工具链重新设计了交互与工作流。
• 内置生成式 AI：无需在多个应用间切换，直接在编辑器内使用 Seedance、Kling、Nano Banana Pro 等模型生成视频与图片。从源码看，模型目录、成本估算与偏好设置分别位于 ModelCatalog.swift、CostEstimator.swift 与 ModelPreferences.swift。
• 与 Agent 生态集成：既可以通过 MCP 连接 Claude / Codex / Cursor 等外部 Agent，也可以使用应用内嵌的 Agent（见 AgentPanelView.swift），双方在同一项目、同一时间线上协作。

下文聚焦文档的核心实操章节——MCP 服务器——并结合仓库源码展开其原理与细节。

二、MCP 服务器：端点、端口与本地安全模型

文档给出的核心事实是：当应用打开时，Palmier Pro 通过 HTTP 在http://127.0.0.1:19789/mcp提供 MCP 服务。这一配置在源码中有精确对应：

• 端口常量定义于 MCPService.swift：static let port: UInt16 = 19789。
• HTTP 服务器实现位于 MCPHTTPServer.swift，它基于Network.framework的NWListener构建，并做了两点关键的安全设计：
  1. 仅绑定 IPv4 回环地址：params.requiredLocalEndpoint = .hostPort(host: "127.0.0.1", port: endpointPort)，注释明确说明「Bind to IPv4 loopback only so the server is never reachable from the LAN」——服务器永远不会被局域网内其他设备访问，只接受本机连接。
  2. 路由白名单：/mcp与/之外的路径统一返回404 Not Found；另外提供/.well-known/oauth-protected-resource端点用于 OAuth 资源发现（见 MCPHTTPServer.swift）。

会话模型与连接复用

从 MCPHTTPServer.swift 可以看到服务器的会话管理机制：

• 有状态会话：客户端通过initialize握手后，服务器分配Mcp-Session-Id头；后续带该头的请求复用同一会话。
• 无状态回退：不带会话头的客户端（包括直接用curl探测）走一个无状态的fallback传输对（StatelessHTTPServerTransport），获得简单的一问一答语义。
• 会话清理：空闲超过 1 小时（sessionIdleLimit = 3600秒）或会话总数达到 32（sessionCountLimit）时，最旧的会话会被驱逐；被驱逐的客户端下一次请求收到 404 后会自动重新initialize，实现透明恢复。
• 请求分帧：请求体可能跨越多次 TCP 读取，服务器会累积数据直到Content-Length满足；单请求体超过 16 MiB 判定为非法（framing(of:)中的16_777_216上限）。

这些细节意味着：外部 Agent 即使长时间闲置或中途断连，重连与工具清单刷新都是自动完成的，无需人工干预。

三、客户端接入配置（官方文档原版命令）

文档为四类客户端给出了可复制的接入方式，以下命令与配置均来自官方文档原文，可直接使用。

3.1 Claude Code（终端命令）

在终端执行一次即可注册：

claude mcp add --transport http palmier-pro http://127.0.0.1:19789/mcp

3.2 Codex（终端命令）

codex mcp add palmier-pro --url http://127.0.0.1:19789/mcp

3.3 Cursor（应用内一键安装或手动配置）

文档推荐的最简方式是：在应用内打开Help→MCP Instructions→Install in Cursor。手动安装则向~/.cursor/mcp.json添加：

{ "mcpServers": { "palmier-pro": { "type": "http", "url": "http://127.0.0.1:19789/mcp" } } }

从 MCPInstructionsPane.swift 可以看到，应用内的「Install in Cursor」按钮实际构造了一个cursor://anysphere.cursor-deeplink/mcp/install?name=palmier-pro&config=...深链，把上面这段 JSON 做 Base64 编码后交给NSWorkspace唤起 Cursor 完成安装。

3.4 Claude Desktop（随应用捆绑的 mcpb 扩展）

文档说明：应用内捆绑了 mcpb 工具链，可一键在 Claude Desktop 上安装 Desktop Extension，路径为Help→MCP Instructions→Install in Claude Desktop。

仓库中对应的捆绑物位于 mcpb/palmier-pro.mcpb（编译产物），其清单与转发脚本源码可直接查看：

• mcpb/manifest.json：声明name: palmier-pro、display_name: Palmier Pro，服务器类型为 Node，入口为server/index.js，兼容darwin平台与node >= 18.0.0。
• mcpb/server/index.js：这是一个stdio → HTTP 转发 shim。Claude Desktop 通过 stdio 与本地 Node 进程通信，shim 再把 JSON-RPC 消息 POST 到http://127.0.0.1:19789/mcp。它实现了完整的会话保持（Mcp-Session-Id头）、指数退避重连（500ms 起步、5s 封顶）、以及一个独立的 GET 流用于接收服务器主动下发的tools/list_changed通知——注释指出之所以用node:http而非fetch，是因为 undici 会在 300 秒后杀死空闲响应体，导致每 5 分钟就白建一次会话。

四、服务器能力：工具与资源（源码佐证）

接入成功后，Agent 能调用哪些能力？文档虽未逐一列举，但源码给出了完整清单，可作为对文档内容的自然延伸：

• 工具注册：在 MCPService.swift 中，服务器把 ToolDefinitions.swift 里的全部工具定义（名称、描述、JSON Schema 输入）注册到 MCPServer，并实现tools/listChanged能力（工具清单动态变化时通知客户端）。
• 工具族：从 ToolDefinitions.swift 的ToolName枚举可见，覆盖了项目管理（manage_project）、时间线读写（get_timeline/inspect_timeline）、媒体库（get_media/import_media/capture_frame）、剪辑操作（add_clips/split_clips/ripple_delete_ranges）、字幕与文字（add_captions/add_texts）、调色与特效（apply_color/apply_effect）、转写（get_transcript/remove_words）、生成（generate_video/generate_image/generate_audio/upscale_media）以及多机位、节拍检测、撤销等。
• 资源：服务器还暴露两个 MCP Resource，URI 为palmier://models/video与palmier://models/image（见 MCPService.swift），返回 JSON 格式的可用生成模型清单，Agent 在执行生成类工具前可先读取它们。
• 会话绑定项目：服务器指令（AgentInstructions.swift）要求会话开始时先调用manage_project（list/open/create/close）绑定项目窗口；工具调用最终都汇聚到 ToolExecutor.swift 及其按领域拆分的扩展文件中执行，并返回标准化的ToolResult（见 ToolResult.swift）。

仓库中还有对应的测试验证这些行为，例如 MCPToolListAnnouncementTests.swift 覆盖工具清单变更通知，ToolExecutorTests.swift 覆盖工具执行参数解析，可作为深入阅读的入口。

五、FAQ：版本、价格与平台支持（文档原答）

哪些版本是开源的？

文档答复：Palmier Pro 到v0.7.6为止的发布版本，以及last-gpl-source分支上的源码，仍以GPLv3授权公开；v0.7.6 之后的版本为专有（proprietary）软件，源码不再发布。本仓库正是保留历史源码、承载当前二进制发布与更新元数据（appcast.xml）的地方。

免费吗？

文档答复分两层：

• 编辑器本身免费：无需登录即可下载，可作为类似 CapCut 或 Adobe Premiere 的普通视频编辑器使用；MCP 服务器同样免费，可以零成本开始用 Claude Code、Claude Desktop 或 Cursor 与时间线编辑器交互。
• 生成式 AI 功能需付费：登录 Palmier 账号并订阅后，才可使用视频/图像生成等生成式 AI 特性。这与源码中的canGenerate逻辑一致——AgentInstructions.swift 指示 Agent：当get_timeline返回canGenerate=false时，生成与超分工具会失败，应提示用户先登录并订阅。

支持哪些平台？

文档答复：目前仅支持：

• macOS 26 (Tahoe)及以上
• 仅 Apple Silicon（M 系列）设备

这也是下载徽章下方小字注明的前提条件，跨平台版本不在当前支持范围内。

六、许可证与社区

• 源码许可：本仓库公开的源码按 GPLv3 授权（Copyright (C) 2026 Palmier, Inc.）。
• 二进制许可：v0.7.6 之后的二进制发布为专有软件，适用 BINARY_LICENSE.md。
• 贡献说明：仓库已不再接受代码贡献，但已发布的源码仍可按 GPLv3 自由使用、修改与再分发。
• 社区与支持：官方提供了 Discord 社区、X（原 Twitter）账号 @Palmier_io、Instagram @palmier.io，以及反馈邮箱 founders@palmier.io；文档同时给出了多语言 README 索引（English / Español / 简体中文 等，阿拉伯语版即本文所依据的 README.ar.md）。

七、快速上手指南（汇总）

1. 在 Apple Silicon 的 macOS 26+ 设备上安装并打开 Palmier Pro。
2. 按需选择接入方式：
   • Claude Code：执行claude mcp add --transport http palmier-pro http://127.0.0.1:19789/mcp；
   • Codex：执行codex mcp add palmier-pro --url http://127.0.0.1:19789/mcp；
   • Cursor：应用内Help→MCP Instructions→Install in Cursor，或手动写入~/.cursor/mcp.json；
   • Claude Desktop：应用内Help→MCP Instructions→Install in Claude Desktop（由捆绑的 mcpb 扩展桥接）。
3. 在 Agent 会话中先调用manage_project打开/绑定项目、再调用get_timeline读取时间线，即可开始让 Agent 直接读剪时间线、生成素材并导出成片。生成式 AI 相关工具需先登录并订阅。

八、注意事项与边界

• 上述命令、端点地址与平台要求均以当前仓库（v0.7.6 历史源码 + 当前发布元数据）为准；若你使用的是 v0.7.6 之后的专有二进制，功能界面以实际发布版本为准。
• 服务器仅监听本机回环地址，任何远程客户端都无法直接访问，这是官方文档与源码共同确认的安全边界。
• 本文未对文档未涉及的性能指标、用户规模或竞品对比做任何断言，相关能力描述均可在仓库源码与测试中找到对应实现。

• 音视频
• 桌面应用
• 人工智能
• MCP 服务
• AI Agent