App Publisher MCP
使用说明(Markdown 格式)
-
项目简介
- 该仓库实现了一个基于 MCP 的服务器,命名为 App Publisher MCP。它向 LLM 客户端提供资源(如图像/元数据存取)、工具(可执行外部功能,如生成图标、发布到商店等)以及可渲染的 Prompt 模板。服务器通过 JSON-RPC 与客户端通信,并且具备多种传输方式支持(这里以标准输入输出为主的实现为起点,后续可扩展为 SSE/WebSocket 等)。
-
主要功能点
- 资源与数据访问:提供资源管理、元数据、Store Listing 相关数据的生成和校验工具。
- 工具注册与执行:支持大量工具(如 configure_api_key、generate_icon、resize_icons、setup_fastlane、publish_ios/publish_android、populate_metadata、validate_metadata、get_status、generate_store_listing、get_publishing_guide、Maestro 相关工具、AdMob/Play Store 集成等)。
- Prompt 模板与渲染:集成具有多语言、自动化生成 Store Listing、隐私政策、审核笔记等内容的能力。
- MCP 服务器核心能力:通过 MCP Server 注册工具、描述、输入输出模式等,提供标准化的 JSON-RPC 风格调用。
- 多平台整合能力:与 Fastlane、Maestro、Gemini、AdMob、Play Store 等服务集成,覆盖 icon 生成、适配多分辨率、商店元数据、广告集成、应用发布等工作流。
- 本仓库的实现基于 @modelcontextprotocol/sdk 的 MCP 服务器端接口,包含对话会话、模型配置、状态查询等能力。
-
安装与运行步骤
- 依赖安装与构建
- 安装依赖命令:npm install
- 构建命令:npm run build
- 启动服务器(构建产物为可执行文件时的典型方式):node dist/index.js
- 配置和运行要点
- 本 MCP 服务器需要一个 Gemini API Key(通过工具 configure_api_key 设置,或者环境变量 GEMINI_API_KEY 提供)。
- 本 MCP 服务器提供多组工具,每个工具都有输入模式(通过 Zod 定义的 schemas)和行为实现。
- Claude/LLM 客户端需要通过 MCP 客户端配置与服务器建立连接,服务器本身提供标准的 MCP 服务能力。
- 依赖安装与构建
-
服务器配置(MCP 客户端需的启动配置示例) 以下是一个与该仓库对应的 MCP 客户端连接配置示例(以 app-publisher 为服务器名,实际在 Claude Code 的 MCP 配置中使用): { "mcpServers": { "app-publisher": { "command": "npx", "args": ["@seungmanchoi/app-publisher-mcp"], "env": { "GEMINI_API_KEY": "your_gemini_api_key_here", "GEMINI_MODEL": "gemini-2.5-flash-image" } /* 说明: - serverName: app-publisher(在 Claude Code 配置中作为唯一标识) - command/args: 启动服务器的命令与参数,配合仓库自带的启动入口 - GEMINI_API_KEY: 调用 Gemini 的 API key(必需) - GEMINI_MODEL: 默认模型ID,可按需覆盖 */ } } }
-
基本使用方法
- 启动服务器后,LLM 客户端(如 Claude Code)通过上述配置连接到 MCP 服务器,便可以调用工具、读取资源、获取 Prompt 模板等能力。
- 常用流程示例(简述):
- 配置 Gemini API Key 与模型;
- 通过工具如 generate_icon、resize_icons、generate_store_listing 等请求执行相应任务;
- 使用 get_status、get_publishing_guide 等工具查看当前配置与发布流程;
- 使用 publish_ios/publish_android 将产出发布到相应商店,或通过 fastlane 进行元数据/截图管理。
- 该实现支持多种工具输入输出,输出以 JSON-RPC 的 content 字段形式返回,包含文本、图片等内容。
-
备注
- 项目包含丰富的工具集合及与多项外部服务的集成实现,若要在生产环境中使用,请确保相关外部服务的凭证、Key、Keyfile 等配置正确,并根据实际需要调整权限、访问范围和网络配置。