Apple开发MCP服务器

一个用于Apple开发辅助的模型上下文协议(MCP)服务器,提供从developer.apple.com获取实时文档、分析Xcode构建错误和检查Swift Evolution提案状态的功能。

  • by erdncyz
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 erdncyz/apple-dev-mcp-server

使用说明

苹果开发MCP服务器🍎

用于苹果开发协助的模型上下文协议(MCP)服务器。提供获取工具 生活 Apple文档直接来自developer.Apple.com,分析Xcode构建错误,并检查Swift Evolution提案状态。

✨ 特性

  • 🔴 实时文档 -从苹果官方API获取实时文档
  • 🔧 Xcode错误分析 -智能解析和修复构建错误的建议
  • 📋 Swift进化追踪 -检查Swift语言功能的提案状态

🔧 工具

工具 说明
fetch_latest_apple_docs 胎儿 生活 Developer.Apple.com上的苹果开发者文档
xcode_diagnostic_analyzer 分析Xcode构建日志并提供修复建议
swift_evolution_check 检查Swift Evolution的语言功能提案状态

📦 安装

通过npm(推荐)

npm install -g apple-dev-mcp-server

通过npx(无需安装)

npx apple-dev-mcp-server

来源

git clone https://github.com/erdncyz/apple-dev-mcp-server.git
cd apple-dev-mcp-server
npm install
npm run build

配置

适用于克劳德桌面

添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-dev": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/Desktop/apple-dev-mcp-server/dist/index.js"]
    }
  }
}

使用GitHub Copilot获取VS代码

添加到您的VS代码设置(.vscode/settings.json 或用户设置):

{
  "github.copilot.chat.mcpServers": {
    "apple-dev": {
      "command": "node",
      "args": ["${userHome}/Desktop/apple-dev-mcp-server/dist/index.js"]
    }
  }
}

对于其他MCP客户端

服务器使用stdio传输,可以与任何兼容MCP的客户端集成:

node /path/to/apple-dev-mcp-server/dist/index.js

使用示例

获取Apple文档

Use the fetch_latest_apple_docs tool to get documentation for NavigationStack

分析构建错误

Use xcode_diagnostic_analyzer to analyze this error:
"cannot find type 'NavigationStack' in scope"

查看Swift进化

Use swift_evolution_check to verify if 'nonisolated(unsafe)' is available in Swift 5.10

🔴 实时文档API

此MCP服务器使用Apple的未记录JSON API来获取 实时文档:

https://developer.apple.com/tutorials/data/documentation/{framework}/{symbol}.json

支持的框架

SwiftUI、UIKit、Foundation、Observation、SwiftData、Combine、RealityKit、ARKit、CoreData、CoreML、MapKit、CloudKit、HealthKit、StoreKit、AVFoundation等。

示例响应

# 📚 Apple Developer Documentation: NavigationStack

> ✅ Live documentation from developer.apple.com

**Type:** Structure
**Framework:** SwiftUI
**Availability:** iOS 16.0+, iPadOS 16.0+, macOS 13.0+, tvOS 16.0+, visionOS 1.0+, watchOS 9.0+

## Declaration
@MainActor struct NavigationStack<Data, Root> where Root : View

## Overview
A view that displays a root view and enables you to present additional views...

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start

项目结构

apple-dev-mcp-server/
├── src/
│   ├── index.ts                 # Main MCP server entry point
│   └── tools/
│       ├── fetch-apple-docs.ts  # Live documentation fetcher
│       ├── xcode-diagnostic-analyzer.ts  # Build error analyzer
│       └── swift-evolution-check.ts      # Swift Evolution checker
├── dist/                        # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

需求

  • Node.js>=18.0.0
  • npm或纱线

📄 许可证

麻省理工学院

🔗 链接


注: 这是一个社区工具,不隶属于或认可苹果股份有限公司。