使用说明
苹果开发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或纱线
📄 许可证
麻省理工学院
🔗 链接
注: 这是一个社区工具,不隶属于或认可苹果股份有限公司。
