UNPKG

@kimsungwhee/apple-docs-mcp

Version:

MCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants

github.com/kimsungwhee/apple-docs-mcp

kimsungwhee/apple-docs-mcp

149 lines • 6.86 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
/** * Configuration constants for Apple Docs MCP */ export declare const API_LIMITS: { readonly MAX_SEARCH_RESULTS: 50; readonly MAX_RELATED_APIS: 10; readonly MAX_REFERENCES: 50; readonly MAX_SIMILAR_APIS: 15; readonly MAX_FRAMEWORK_DEPTH: 10; readonly DEFAULT_FRAMEWORK_DEPTH: 3; readonly DEFAULT_FRAMEWORK_SYMBOLS_LIMIT: 50; readonly DEFAULT_DOCUMENTATION_UPDATES_LIMIT: 50; readonly DEFAULT_TECHNOLOGY_OVERVIEWS_LIMIT: 50; readonly DEFAULT_SAMPLE_CODE_LIMIT: 50; readonly DEFAULT_TECHNOLOGIES_LIMIT: 200; readonly DEFAULT_REFERENCES_LIMIT: 20; readonly MAX_FRAMEWORK_SYMBOLS_LIMIT: 200; readonly MAX_DOCUMENTATION_UPDATES_LIMIT: 200; readonly MAX_TECHNOLOGY_OVERVIEWS_LIMIT: 200; readonly MAX_SAMPLE_CODE_LIMIT: 200; readonly MAX_TECHNOLOGIES_LIMIT: 500; readonly MAX_REFERENCES_LIMIT: 50; }; export declare const SEARCH_DEPTH_LIMITS: { readonly shallow: 5; readonly medium: 10; readonly deep: 15; }; export declare const CACHE_TTL: { readonly API_DOCS: number; readonly SEARCH_RESULTS: number; readonly FRAMEWORK_INDEX: number; readonly TECHNOLOGIES: number; readonly UPDATES: number; readonly SAMPLE_CODE: number; readonly TECHNOLOGY_OVERVIEWS: number; }; export declare const CACHE_SIZE: { readonly API_DOCS: 500; readonly SEARCH_RESULTS: 200; readonly FRAMEWORK_INDEX: 100; readonly TECHNOLOGIES: 50; readonly UPDATES: 100; readonly SAMPLE_CODE: 100; readonly TECHNOLOGY_OVERVIEWS: 100; readonly DEFAULT_CACHE_SIZE: 1000; readonly DEFAULT_CACHE_TTL: number; }; export declare const REQUEST_CONFIG: { readonly TIMEOUT: 30000; readonly MAX_RETRIES: 3; readonly RETRY_DELAY: 1000; readonly MAX_CONCURRENT_REQUESTS: 5; readonly USER_AGENT: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"; }; export declare const RATE_LIMIT: { readonly MAX_REQUESTS_PER_MINUTE: 100; readonly WINDOW_MS: 60000; }; export declare const PROCESSING_LIMITS: { readonly MAX_COLLECTIONS_TO_SHOW: 5; readonly MAX_RELATED_APIS_PER_SECTION: 3; readonly MAX_PLATFORM_COMPATIBILITY_ITEMS: 2; readonly MAX_SIMILAR_APIS_FOR_DEEP_SEARCH: 3; readonly MAX_TOPIC_IDENTIFIERS: 4; readonly MAX_DOC_FETCHER_RELATED_APIS: 10; readonly MAX_DOC_FETCHER_REFERENCES: 15; readonly MAX_DOC_FETCHER_SIMILAR_APIS: 8; readonly MAX_DOC_FETCHER_REFS_PER_TYPE: 5; readonly RESPONSE_TIME_GOOD_THRESHOLD: 1000; readonly RESPONSE_TIME_MODERATE_THRESHOLD: 3000; }; export declare const APPLE_URLS: { readonly BASE: "https://developer.apple.com"; readonly SEARCH: "https://developer.apple.com/search/"; readonly DOCUMENTATION: "https://developer.apple.com/documentation/"; readonly TUTORIALS_DATA: "https://developer.apple.com/tutorials/data/"; readonly TECHNOLOGIES_JSON: "https://developer.apple.com/tutorials/data/documentation/technologies.json"; readonly UPDATES_JSON: "https://developer.apple.com/tutorials/data/documentation/Updates.json"; readonly UPDATES_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/updates"; readonly TECHNOLOGY_OVERVIEWS_JSON: "https://developer.apple.com/tutorials/data/documentation/TechnologyOverviews.json"; readonly TECHNOLOGY_OVERVIEWS_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/technologyoverviews"; readonly SAMPLE_CODE_JSON: "https://developer.apple.com/tutorials/data/documentation/SampleCode.json"; readonly SAMPLE_CODE_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/samplecode"; }; export declare const WWDC_URLS: { readonly BASE: "https://developer.apple.com/videos"; readonly TOPICS: "https://developer.apple.com/videos/topics/"; readonly YEAR_BASE: "https://developer.apple.com/videos/wwdc"; readonly PLAY_BASE: "https://developer.apple.com/videos/play/wwdc"; readonly getYearUrl: (year: string) => string; readonly getVideoUrl: (year: string, videoId: string) => string; readonly getCodeUrl: (year: string, videoId: string) => string; readonly getTranscriptUrl: (year: string, videoId: string) => string; readonly getResourcesUrl: (year: string, videoId: string) => string; readonly getTopicUrl: (topicId: string) => string; }; export declare const WWDC_CONFIG: { readonly EARLIEST_YEAR: 2014; readonly LATEST_YEAR: 2025; readonly CODE_TAB_INTRODUCED_YEAR: 2022; readonly AVAILABLE_YEARS: readonly ["2014", "2015", "2016", "2017", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025"]; readonly DEFAULT_VIDEO_LIMIT: 50; readonly DEFAULT_CODE_EXAMPLES_LIMIT: 30; readonly DEFAULT_SEARCH_LIMIT: 20; readonly DEFAULT_RELATED_VIDEOS_LIMIT: 15; readonly DEFAULT_TOPIC_VIDEOS_LIMIT: 20; readonly MAX_VIDEO_LIMIT: 200; readonly MAX_CODE_EXAMPLES_LIMIT: 100; readonly MAX_SEARCH_LIMIT: 100; readonly MAX_RELATED_VIDEOS_LIMIT: 50; readonly MAX_TOPIC_VIDEOS_LIMIT: 100; readonly MIN_CODE_LENGTH: 10; readonly MAX_CONTEXT_MATCHES: 3; readonly MAX_TOPIC_VIDEOS_FOR_SCORING: 10; readonly CACHE_TTL: number; }; export declare const WWDC_DATA_SOURCE_CONFIG: { readonly github: { readonly owner: "kimsungwhee"; readonly repo: "apple-docs-mcp"; readonly branch: "main"; readonly baseUrl: "https://cdn.jsdelivr.net/gh/kimsungwhee/apple-docs-mcp@main/data/wwdc"; }; readonly local: { readonly dataDir: "data/wwdc"; }; readonly filePaths: { readonly globalMetadata: "index.json"; readonly topicIndex: (topicId: string) => string; readonly yearIndex: (year: string) => string; readonly videoData: (year: string, videoId: string) => string; readonly allVideos: "all-videos.json"; }; }; export declare const ERROR_MESSAGES: { readonly INVALID_URL: "URL must be from developer.apple.com"; readonly FETCH_FAILED: "Failed to fetch data from Apple Developer Documentation"; readonly PARSE_FAILED: "Failed to parse response data"; readonly NOT_FOUND: "Documentation not found (404). This URL may have been moved or removed."; readonly TIMEOUT: "Request timed out. Please try again later."; readonly NETWORK_ERROR: "Network error occurred. Please check your connection."; readonly RATE_LIMITED: "Request rate limit exceeded. Please wait before trying again."; readonly API_ERROR: "API error occurred while processing the request."; readonly CACHE_ERROR: "Cache operation failed, but the request will continue."; readonly VALIDATION_ERROR: "Input validation failed. Please check your parameters."; readonly SERVICE_UNAVAILABLE: "Apple Developer Documentation service is temporarily unavailable."; }; //# sourceMappingURL=constants.d.ts.map