@mweinbach/apple-docs-mcp 1.0.0

package/dist/utils/wwdc-data-source.js

@@ -0,0 +1,133 @@
+/**
+ * WWDC Data Source - Loads data from bundled JSON files
+ *
+ * This module provides functions to load WWDC video data from
+ * JSON files that are bundled with the npm package.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { logger } from './logger.js';
+import { wwdcDataCache } from './cache.js';
+import { WWDC_CONFIG } from './constants.js';
+import { getWWDCDataDirectory } from './wwdc-data-source-path.js';
+// Get the data directory from the separate module
+const WWDC_DATA_DIR = getWWDCDataDirectory();
+/**
+ * Read file from bundled data directory
+ */
+async function readBundledFile(filePath) {
+    const fullPath = path.join(WWDC_DATA_DIR, filePath);
+    try {
+        const content = await fs.readFile(fullPath, 'utf-8');
+        logger.debug(`Loaded bundled data: ${filePath}`);
+        return content;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to read bundled data: ${filePath}`, error);
+        throw new Error(`Failed to load WWDC data from ${filePath}: ${errorMessage}`);
+    }
+}
+/**
+ * Fetch data with caching support
+ */
+async function fetchData(filePath) {
+    const cacheKey = `wwdc:${filePath}`;
+    // Check cache first
+    const cached = wwdcDataCache.get(cacheKey);
+    if (cached) {
+        logger.debug(`Cache hit: ${filePath}`);
+        return cached;
+    }
+    // Read from bundled data
+    const data = await readBundledFile(filePath);
+    // Cache the data
+    wwdcDataCache.set(cacheKey, data, WWDC_CONFIG.CACHE_TTL);
+    return data;
+}
+/**
+ * Load global metadata (index.json)
+ */
+export async function loadGlobalMetadata() {
+    try {
+        const data = await fetchData('index.json');
+        return JSON.parse(data);
+    }
+    catch (error) {
+        logger.error('Failed to load global metadata', error);
+        throw new Error('Failed to load WWDC metadata. Please ensure the package is properly installed.');
+    }
+}
+/**
+ * Load topic index
+ */
+export async function loadTopicIndex(topicId) {
+    try {
+        const data = await fetchData(`by-topic/${topicId}/index.json`);
+        return JSON.parse(data);
+    }
+    catch (error) {
+        logger.error(`Failed to load topic index: ${topicId}`, error);
+        throw new Error(`Topic not found: ${topicId}`);
+    }
+}
+/**
+ * Load year index
+ */
+export async function loadYearIndex(year) {
+    try {
+        const data = await fetchData(`by-year/${year}/index.json`);
+        return JSON.parse(data);
+    }
+    catch (error) {
+        logger.error(`Failed to load year index: ${year}`, error);
+        throw new Error(`Year not found: ${year}`);
+    }
+}
+/**
+ * Load individual video data
+ */
+export async function loadVideoData(year, videoId) {
+    try {
+        const data = await fetchData(`videos/${year}-${videoId}.json`);
+        return JSON.parse(data);
+    }
+    catch (error) {
+        logger.error(`Failed to load video: ${year}-${videoId}`, error);
+        throw new Error(`Video not found: ${year}-${videoId}`);
+    }
+}
+/**
+ * Load all videos list
+ */
+export async function loadAllVideos() {
+    try {
+        const data = await fetchData('all-videos.json');
+        return JSON.parse(data);
+    }
+    catch (error) {
+        logger.error('Failed to load all videos', error);
+        throw new Error('Failed to load WWDC video list');
+    }
+}
+/**
+ * Clear the WWDC data cache
+ */
+export function clearDataCache() {
+    wwdcDataCache.clear();
+    logger.info('WWDC data cache cleared');
+}
+/**
+ * Check if WWDC data is available
+ */
+export async function isDataAvailable() {
+    try {
+        await fs.access(WWDC_DATA_DIR);
+        await fs.access(path.join(WWDC_DATA_DIR, 'index.json'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wwdc-data-source.js.map

package/dist/utils/wwdc-data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wwdc-data-source.js","sourceRoot":"","sources":["../../src/utils/wwdc-data-source.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@mweinbach/apple-docs-mcp",
+  "version": "1.0.0",
+  "description": "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",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "apple-docs-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.*.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mweinbach/apple-docs-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mweinbach/apple-docs-mcp/issues"
+  },
+  "homepage": "https://github.com/mweinbach/apple-docs-mcp#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --ci --coverage --watchAll=false",
+    "prepublishOnly": "bun run clean && bun run build && bun run test:ci",
+    "release:patch": "npm version patch && git push origin main --tags && bun publish",
+    "release:minor": "npm version minor && git push origin main --tags && bun publish",
+    "release:major": "npm version major && git push origin main --tags && bun publish"
+  },
+  "keywords": [
+    "mcp",
+    "apple",
+    "developer-documentation",
+    "ios",
+    "macos",
+    "swift",
+    "objective-c",
+    "api-search",
+    "framework-documentation",
+    "sample-code",
+    "apple-apis"
+  ],
+  "author": "mweinbach",
+  "contributors": [
+    {
+      "name": "kimsungwhee",
+      "url": "https://github.com/kimsungwhee"
+    }
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "cheerio": "^1.1.0",
+    "zod": "^3.23.8",
+    "jsdom": "^26.1.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.4",
+    "@types/jest": "^30.0.0",
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.1",
+    "jest": "^30.0.4",
+    "ts-jest": "^29.4.0",
+    "tsx": "^4.20.3",
+    "typescript": "^5.3.3"
+  }
+}