使用说明内容（Markdown格式）

• 项目简介
  • 这是一个基于 .NET 的 MCP 服务器实现，旨在为 LLM 客户端提供通过 App Store Connect API 获取 Xcode Cloud 构建信息、日志、工件以及 App Store 提交相关功能的能力集合。服务器暴露一组通过 MCP 工具调用的功能，支持多种传输方式（如标准输入/输出，后续可扩展为 SSE、WebSocket 等）。
• 主要功能点
  • 访问 Xcode Cloud 与 App Store Connect 的数据：列出产品、构建、构建步骤、工件、测试结果、问题等。
  • 获取构建日志：下载并解析 Xcode 构建日志，返回有用的错误信息。
  • App Store 提交工作流相关工具：管理应用版本、截图、截图集、年龄分级、评审信息、提交与就绪性检查等。
  • 安全与认证：使用 App Store Connect API 的 JWT 认证方式实现请求授权。
  • 开箱即用的 MCP 服务：通过 WithStdioServerTransport 启动，工具类通过程序集自动暴露给 MCP 客户端。
• 安装步骤
  • 安装 .NET 8.0 SDK 或更高版本。
  • 构建/发布可执行文件：
    • 通过源码构建：git clone https://github.com/Stig-Johnny/appstoreconnect-mcp.git，进入 AppStoreConnectMcp 目录，执行 dotnet publish -c Release -r <你的平台>。
    • 使用仓库提供的预构建二进制直接运行（若有发行版本）。
  • 设置环境变量（必填，任选其二）
    • APP_STORE_CONNECT_KEY_ID：API Key ID，例如 ABC123DEF4
    • APP_STORE_CONNECT_ISSUER_ID：Issuer ID（UUID 格式）
    • APP_STORE_CONNECT_KEY_PATH：私钥 .p8 文件路径
    • 或 APP_STORE_CONNECT_KEY_CONTENT：私钥内容（替代 KEY_PATH，二选一）
• 服务器配置（MCP 客户端需要的最小信息） 服务器端需要通过 MCP 客户端配置连接信息，示例配置（JSON 表达）如下，实际执行路径和参数需按你环境提供： { "serverName": "appstoreconnect", "type": "stdio", "command": "/path/to/appstoreconnect-mcp-osx-arm64/AppStoreConnectMcp", "args": [], "env": { "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID", "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID", "APP_STORE_CONNECT_KEY_PATH": "/path/to/AuthKey_XXXX.p8" } } 注释：
  • serverName 为 MCP 客户端识别的名称，type 指定传输类型（此实现为 stdio）。command 指向可执行程序的启动命令，args 如需传参可在此添加。env 为必要的环境变量配置，确保 APP_STORE_CONNECT_KEY_ID、APP_STORE_CONNECT_ISSUER_ID、KEY_PATH/KEY_CONTENT 至少一个被提供。
• 基本使用方法
  • 启动服务器后，MCP 客户端通过标准输入/输出连接，调用定义好的工具（如 ListProducts、ListBuilds、GetBuildRun、ListArtifacts、GetBuildLogs、UploadScreenshots 等）以获取 App Store Connect 的数据与操作能力。
  • 客户端通过 JSON-RPC 风格的调用向服务器发起请求，服务器返回结构化的 JSON 响应，便于 LLM 进行解析与后续处理。