@get-technology-inc/jamf-docs-mcp-server 0.0.1 → 1.0.0

package/dist/constants.js

@@ -0,0 +1,303 @@
+/**
+ * Constants for Jamf Docs MCP Server
+ *
+ * Note: Jamf documentation has moved from docs.jamf.com to learn.jamf.com
+ * The new URL structure is: learn.jamf.com/en-US/bundle/{product}-documentation/page/{page}.html
+ */
+// Environment variable helpers
+const getEnvNumber = (key, defaultValue) => {
+    const value = process.env[key];
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+};
+const getEnvString = (key, defaultValue) => {
+    return process.env[key] ?? defaultValue;
+};
+// Base URLs
+export const DOCS_BASE_URL = 'https://learn.jamf.com';
+export const LEARN_BASE_URL = 'https://learn.jamf.com';
+export const DOCS_API_URL = 'https://learn-be.jamf.com';
+// Supported products - updated URL patterns for learn.jamf.com
+export const JAMF_PRODUCTS = {
+    'jamf-pro': {
+        id: 'jamf-pro',
+        name: 'Jamf Pro',
+        description: 'Apple device management for enterprise',
+        urlPattern: 'en-US/bundle/jamf-pro-documentation/page',
+        bundleId: 'jamf-pro-documentation',
+        searchLabel: 'product-pro', // Label used in Zoomin search API
+        latestVersion: 'current',
+        versions: ['current'] // learn.jamf.com uses latest version only
+    },
+    'jamf-school': {
+        id: 'jamf-school',
+        name: 'Jamf School',
+        description: 'Apple device management for education',
+        urlPattern: 'en-US/bundle/jamf-school-documentation/page',
+        bundleId: 'jamf-school-documentation',
+        searchLabel: 'product-school',
+        latestVersion: 'current',
+        versions: ['current']
+    },
+    'jamf-connect': {
+        id: 'jamf-connect',
+        name: 'Jamf Connect',
+        description: 'Identity and access management',
+        urlPattern: 'en-US/bundle/jamf-connect-documentation/page',
+        bundleId: 'jamf-connect-documentation',
+        searchLabel: 'product-connect',
+        latestVersion: 'current',
+        versions: ['current']
+    },
+    'jamf-protect': {
+        id: 'jamf-protect',
+        name: 'Jamf Protect',
+        description: 'Endpoint security for Apple',
+        urlPattern: 'en-US/bundle/jamf-protect-documentation/page',
+        bundleId: 'jamf-protect-documentation',
+        searchLabel: 'product-protect',
+        latestVersion: 'current',
+        versions: ['current']
+    }
+};
+// Response format
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["MARKDOWN"] = "markdown";
+    ResponseFormat["JSON"] = "json";
+})(ResponseFormat || (ResponseFormat = {}));
+// Cache settings (in milliseconds) - configurable via environment variables
+export const CACHE_TTL = {
+    SEARCH_RESULTS: getEnvNumber('CACHE_TTL_SEARCH', 30 * 60 * 1000), // 30 minutes
+    ARTICLE_CONTENT: getEnvNumber('CACHE_TTL_ARTICLE', 24 * 60 * 60 * 1000), // 24 hours
+    PRODUCT_LIST: getEnvNumber('CACHE_TTL_PRODUCTS', 7 * 24 * 60 * 60 * 1000), // 7 days
+    TOC: getEnvNumber('CACHE_TTL_TOC', 24 * 60 * 60 * 1000) // 24 hours
+};
+// Cache directory - configurable via environment variable
+export const CACHE_DIR = getEnvString('CACHE_DIR', '.cache');
+// Request settings - configurable via environment variables
+export const REQUEST_CONFIG = {
+    TIMEOUT: getEnvNumber('REQUEST_TIMEOUT', 15000), // 15 seconds
+    MAX_RETRIES: getEnvNumber('MAX_RETRIES', 3),
+    RETRY_DELAY: getEnvNumber('RETRY_DELAY', 1000), // 1 second
+    RATE_LIMIT_DELAY: getEnvNumber('RATE_LIMIT_DELAY', 500), // 500ms between requests
+    USER_AGENT: getEnvString('USER_AGENT', 'JamfDocsMCP/1.0 (https://github.com/GET-Technology-Inc/jamf-docs-mcp-server)')
+};
+// Content limits
+export const CONTENT_LIMITS = {
+    MAX_SEARCH_RESULTS: 50,
+    DEFAULT_SEARCH_RESULTS: 10,
+    MAX_CONTENT_LENGTH: 100000, // 100KB
+    MAX_SNIPPET_LENGTH: 500
+};
+// Token configuration (Context7 style)
+export const TOKEN_CONFIG = {
+    DEFAULT_MAX_TOKENS: 5000,
+    MAX_TOKENS_LIMIT: 20000,
+    MIN_TOKENS: 100,
+    CHARS_PER_TOKEN: 4, // Estimation ratio
+    CODE_CHARS_PER_TOKEN: 3 // Code blocks have higher token density
+};
+// Pagination configuration
+export const PAGINATION_CONFIG = {
+    DEFAULT_PAGE: 1,
+    DEFAULT_PAGE_SIZE: 10,
+    MAX_PAGE: 100
+};
+// Topic categories for filtering (comprehensive list based on actual Jamf documentation)
+export const JAMF_TOPICS = {
+    // === Enrollment & Onboarding ===
+    'enrollment': {
+        name: 'Enrollment & Onboarding',
+        keywords: ['enroll', 'dep', 'ade', 'automated device enrollment', 'user enrollment', 'apple configurator', 'onboard', 'prestage', 'enrollment method']
+    },
+    // === Device Management ===
+    'computer-management': {
+        name: 'Computer Management',
+        keywords: ['computer management', 'computer inventory', 'remote command', 'remote administration', 'mass action', 'unmanag', 'check-in', 'startup script', 'login event']
+    },
+    'mobile-management': {
+        name: 'Mobile Device Management',
+        keywords: ['mobile device', 'iphone', 'ipad', 'ios', 'ipados', 'mobile inventory', 'mdm capabilities']
+    },
+    // === Configuration ===
+    'profiles': {
+        name: 'Configuration Profiles',
+        keywords: ['configuration profile', 'profile', 'payload', 'restriction', 'settings management', 'computer configuration', 'mobile configuration']
+    },
+    'policies': {
+        name: 'Policies',
+        keywords: ['policy', 'policies', 'execution frequency', 'user interaction', 'policy management', 'policy payload', 'trigger']
+    },
+    // === Software & Packages ===
+    'packages': {
+        name: 'Packages & Deployment',
+        keywords: ['package', 'pkg', 'dmg', 'package deployment', 'package management', 'installer']
+    },
+    'scripts': {
+        name: 'Scripts',
+        keywords: ['script', 'bash', 'shell', 'login script', 'startup script', 'extension attribute']
+    },
+    'patch': {
+        name: 'Patch Management',
+        keywords: ['patch', 'patch management', 'patch policy', 'software update', 'patch reporting', 'software title', 'patch source']
+    },
+    'apps': {
+        name: 'App Management',
+        keywords: ['app', 'application', 'app installer', 'vpp', 'volume purchase', 'managed app', 'app store', 'mac app store']
+    },
+    // === Self Service ===
+    'self-service': {
+        name: 'Self Service',
+        keywords: ['self service', 'self-service', 'dock item', 'branding', 'bookmark', 'user portal']
+    },
+    // === Security ===
+    'security': {
+        name: 'Security Settings',
+        keywords: ['security', 'security settings', 'restricted software', 'efi password', 'firmware password', 'gatekeeper']
+    },
+    'filevault': {
+        name: 'FileVault & Encryption',
+        keywords: ['filevault', 'encryption', 'recovery key', 'disk encryption', 'institutional recovery', 'personal recovery']
+    },
+    'compliance': {
+        name: 'Compliance & Baseline',
+        keywords: ['compliance', 'baseline', 'compliance baseline', 'security benchmark', 'cis benchmark', 'gdpr']
+    },
+    // === Endpoint Protection (Jamf Protect) ===
+    'protect-analytics': {
+        name: 'Threat Analytics',
+        keywords: ['analytic', 'threat', 'detection', 'analytic chain', 'custom analytic', 'jamf-managed analytic', 'alert']
+    },
+    'protect-plans': {
+        name: 'Protect Plans',
+        keywords: ['protect plan', 'jamf protect plan', 'threat prevention', 'endpoint security']
+    },
+    'data-integration': {
+        name: 'SIEM & Data Integration',
+        keywords: ['siem', 'splunk', 'sentinel', 'elastic', 'datadog', 'sumo logic', 'google secops', 'amazon s3', 'data stream', 'data integration']
+    },
+    // === Identity & Authentication ===
+    'sso': {
+        name: 'Single Sign-On',
+        keywords: ['sso', 'single sign-on', 'saml', 'oidc', 'oauth', 'jamf account', 'platform sso']
+    },
+    'ldap': {
+        name: 'Directory Services',
+        keywords: ['ldap', 'active directory', 'directory binding', 'open directory', 'google secure ldap']
+    },
+    'identity-provider': {
+        name: 'Identity Providers',
+        keywords: ['identity provider', 'idp', 'okta', 'azure ad', 'entra id', 'microsoft entra', 'google', 'cloud identity']
+    },
+    // === Jamf Connect ===
+    'connect-login': {
+        name: 'Jamf Connect Login',
+        keywords: ['jamf connect', 'login window', 'local account', 'account creation', 'account migration', 'mobile account']
+    },
+    'connect-password': {
+        name: 'Password & Keychain',
+        keywords: ['password sync', 'keychain', 'password policy', 'local password']
+    },
+    'privilege-elevation': {
+        name: 'Privilege Elevation',
+        keywords: ['privilege elevation', 'admin rights', 'sudo', 'privilege', 'self service+']
+    },
+    // === Users & Accounts ===
+    'users': {
+        name: 'Users & Accounts',
+        keywords: ['user account', 'local account', 'managed local administrator', 'mdm-enabled', 'user group', 'admin account']
+    },
+    'user-roles': {
+        name: 'Roles & Permissions',
+        keywords: ['user role', 'permission', 'privilege', 'administrator role', 'api role', 'access level']
+    },
+    // === Inventory & Reporting ===
+    'inventory': {
+        name: 'Inventory',
+        keywords: ['inventory', 'inventory collection', 'inventory display', 'hardware inventory', 'software inventory', 'inventory preload']
+    },
+    'extension-attributes': {
+        name: 'Extension Attributes',
+        keywords: ['extension attribute', 'custom attribute', 'ea', 'custom field', 'inventory attribute']
+    },
+    'reports': {
+        name: 'Reports & Searches',
+        keywords: ['report', 'search', 'advanced search', 'simple search', 'smart group', 'criteria', 'computer report']
+    },
+    'history': {
+        name: 'History & Logs',
+        keywords: ['history', 'log', 'audit', 'audit log', 'computer history', 'management history', 'server log']
+    },
+    // === API & Integration ===
+    'api': {
+        name: 'API & Automation',
+        keywords: ['api', 'rest api', 'classic api', 'jamf pro api', 'api role', 'api client', 'bearer token']
+    },
+    'graphql': {
+        name: 'GraphQL API',
+        keywords: ['graphql', 'query', 'mutation', 'schema', 'protect api']
+    },
+    'webhooks': {
+        name: 'Webhooks & Notifications',
+        keywords: ['webhook', 'notification', 'email notification', 'impact alert', 'event']
+    },
+    // === Network & Printing ===
+    'network': {
+        name: 'Network Configuration',
+        keywords: ['wifi', 'vpn', 'network', 'proxy', 'firewall', 'port', 'ip address', 'url']
+    },
+    'certificates': {
+        name: 'Certificates',
+        keywords: ['certificate', 'ssl', 'scep', 'push certificate', 'apns', 'signing']
+    },
+    'printers': {
+        name: 'Printers',
+        keywords: ['printer', 'print', 'cups', 'ppd']
+    },
+    // === Remote Access ===
+    'remote-access': {
+        name: 'Remote Access',
+        keywords: ['remote assist', 'jamf remote', 'teamviewer', 'screen sharing', 'vnc', 'remote administration']
+    },
+    // === Server Administration ===
+    'server-admin': {
+        name: 'Server Administration',
+        keywords: ['server', 'jamf pro server', 'activation code', 'smtp', 'ssl certificate', 'maintenance', 'health check', 'clustering']
+    },
+    'change-management': {
+        name: 'Change Management',
+        keywords: ['change management', 'change log', 'version', 'backup', 'restore']
+    },
+    // === License Management ===
+    'licensing': {
+        name: 'License Management',
+        keywords: ['license', 'licensed software', 'license compliance', 'license usage', 'vpp token']
+    },
+    // === Education (Jamf School) ===
+    'education': {
+        name: 'Education & Classroom',
+        keywords: ['school', 'class', 'teacher', 'student', 'jamf teacher', 'jamf student', 'jamf parent', 'classroom', 'education']
+    },
+    'school-integration': {
+        name: 'School Integrations',
+        keywords: ['apple school manager', 'asm', 'shared ipad', 'location', 'google classroom']
+    }
+};
+// HTML selectors for learn.jamf.com (React-based site)
+export const SELECTORS = {
+    // Main content - learn.jamf.com uses semantic article tag
+    CONTENT: 'article, .article-content, main article, #content',
+    TITLE: 'h1',
+    // Navigation - learn.jamf.com structure
+    BREADCRUMB: '[class*="breadcrumb"] a, nav[aria-label="breadcrumb"] a',
+    TOC: 'nav.related-links a, [class*="toc"] a, [class*="sidebar"] a',
+    // Related content
+    RELATED: 'nav.related-links a, .related-topics a, [class*="related"] a',
+    // Elements to remove (scripts, tracking, etc.)
+    REMOVE: 'script, style, noscript, footer, [id="initial-data"], [class*="cookie"], [class*="tracking"], [class*="analytics"]'
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Jamf Docs MCP Server
+ *
+ * An MCP server that provides access to Jamf documentation (docs.jamf.com)
+ * for AI assistants like Claude.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Jamf Docs MCP Server
+ *
+ * An MCP server that provides access to Jamf documentation (docs.jamf.com)
+ * for AI assistants like Claude.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerSearchTool } from './tools/search.js';
+import { registerGetArticleTool } from './tools/get-article.js';
+import { registerListProductsTool } from './tools/list-products.js';
+import { registerGetTocTool } from './tools/get-toc.js';
+// Create server instance
+const server = new McpServer({
+    name: 'jamf-docs-mcp-server',
+    version: '1.0.0',
+});
+// Register all tools
+registerListProductsTool(server);
+registerSearchTool(server);
+registerGetArticleTool(server);
+registerGetTocTool(server);
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (not stdout, which is used for MCP protocol)
+    console.error('Jamf Docs MCP Server running on stdio');
+    console.error('Available tools: jamf_docs_list_products, jamf_docs_search, jamf_docs_get_article, jamf_docs_get_toc');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,yBAAyB;AACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,sGAAsG,CAAC,CAAC;AACxH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Zod schemas for input validation
+ */
+import { z } from 'zod';
+import { ResponseFormat } from '../constants.js';
+/**
+ * Schema for jamf_docs_list_products
+ */
+export declare const ListProductsInputSchema: z.ZodObject<{
+    maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    responseFormat: ResponseFormat;
+    maxTokens?: number | undefined;
+}, {
+    maxTokens?: number | undefined;
+    responseFormat?: ResponseFormat | undefined;
+}>;
+export type ListProductsInput = z.infer<typeof ListProductsInputSchema>;
+/**
+ * Schema for jamf_docs_search
+ */
+export declare const SearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    product: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    topic: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+    version: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    query: string;
+    responseFormat: ResponseFormat;
+    limit: number;
+    version?: string | undefined;
+    maxTokens?: number | undefined;
+    product?: string | undefined;
+    topic?: string | undefined;
+    page?: number | undefined;
+}, {
+    query: string;
+    version?: string | undefined;
+    maxTokens?: number | undefined;
+    responseFormat?: ResponseFormat | undefined;
+    product?: string | undefined;
+    topic?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}>;
+export type SearchInput = z.infer<typeof SearchInputSchema>;
+/**
+ * Schema for jamf_docs_get_article
+ */
+export declare const GetArticleInputSchema: z.ZodObject<{
+    url: z.ZodEffects<z.ZodString, string, string>;
+    section: z.ZodOptional<z.ZodString>;
+    includeRelated: z.ZodDefault<z.ZodBoolean>;
+    maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    url: string;
+    responseFormat: ResponseFormat;
+    includeRelated: boolean;
+    maxTokens?: number | undefined;
+    section?: string | undefined;
+}, {
+    url: string;
+    maxTokens?: number | undefined;
+    responseFormat?: ResponseFormat | undefined;
+    section?: string | undefined;
+    includeRelated?: boolean | undefined;
+}>;
+export type GetArticleInput = z.infer<typeof GetArticleInputSchema>;
+/**
+ * Schema for jamf_docs_get_toc
+ */
+export declare const GetTocInputSchema: z.ZodObject<{
+    product: z.ZodEnum<[string, ...string[]]>;
+    version: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    maxTokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    responseFormat: ResponseFormat;
+    product: string;
+    version?: string | undefined;
+    maxTokens?: number | undefined;
+    page?: number | undefined;
+}, {
+    product: string;
+    version?: string | undefined;
+    maxTokens?: number | undefined;
+    responseFormat?: ResponseFormat | undefined;
+    page?: number | undefined;
+}>;
+export type GetTocInput = z.infer<typeof GetTocInputSchema>;
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EAMf,MAAM,iBAAiB,CAAC;AA2BzB;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;EAQzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAwBvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAmBnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,110 @@
+/**
+ * Zod schemas for input validation
+ */
+import { z } from 'zod';
+import { ResponseFormat, JAMF_PRODUCTS, CONTENT_LIMITS, TOKEN_CONFIG, PAGINATION_CONFIG, JAMF_TOPICS } from '../constants.js';
+// Valid product IDs
+const productIds = Object.keys(JAMF_PRODUCTS);
+// Valid topic IDs
+const topicIds = Object.keys(JAMF_TOPICS);
+// Response format enum
+const ResponseFormatSchema = z.nativeEnum(ResponseFormat);
+// Common maxTokens parameter schema
+const MaxTokensSchema = z.number()
+    .int()
+    .min(TOKEN_CONFIG.MIN_TOKENS)
+    .max(TOKEN_CONFIG.MAX_TOKENS_LIMIT)
+    .default(TOKEN_CONFIG.DEFAULT_MAX_TOKENS)
+    .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`);
+// Common page parameter schema
+const PageSchema = z.number()
+    .int()
+    .min(1)
+    .max(PAGINATION_CONFIG.MAX_PAGE)
+    .default(PAGINATION_CONFIG.DEFAULT_PAGE)
+    .describe(`Page number (1-${PAGINATION_CONFIG.MAX_PAGE}, default: 1)`);
+/**
+ * Schema for jamf_docs_list_products
+ */
+export const ListProductsInputSchema = z.object({
+    maxTokens: MaxTokensSchema
+        .optional()
+        .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    responseFormat: ResponseFormatSchema
+        .default(ResponseFormat.MARKDOWN)
+        .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
+}).strict();
+/**
+ * Schema for jamf_docs_search
+ */
+export const SearchInputSchema = z.object({
+    query: z.string()
+        .min(2, 'Query must be at least 2 characters')
+        .max(200, 'Query must not exceed 200 characters')
+        .describe('Search keywords to find in Jamf documentation'),
+    product: z.enum(productIds)
+        .optional()
+        .describe('Filter by product: jamf-pro, jamf-school, jamf-connect, jamf-protect'),
+    topic: z.enum(topicIds)
+        .optional()
+        .describe('Filter by topic: enrollment, profiles, security, inventory, policies, smart-groups, apps, identity, api, network'),
+    version: z.string()
+        .optional()
+        .describe('Filter by version (e.g., "11.5.0", "10.x")'),
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(CONTENT_LIMITS.MAX_SEARCH_RESULTS)
+        .default(CONTENT_LIMITS.DEFAULT_SEARCH_RESULTS)
+        .describe(`Maximum number of results per page (1-${CONTENT_LIMITS.MAX_SEARCH_RESULTS})`),
+    page: PageSchema
+        .optional()
+        .describe(`Page number for pagination (1-${PAGINATION_CONFIG.MAX_PAGE}, default: 1)`),
+    maxTokens: MaxTokensSchema
+        .optional()
+        .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    responseFormat: ResponseFormatSchema
+        .default(ResponseFormat.MARKDOWN)
+        .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
+}).strict();
+/**
+ * Schema for jamf_docs_get_article
+ */
+export const GetArticleInputSchema = z.object({
+    url: z.string()
+        .url('Must be a valid URL')
+        .refine((url) => url.includes('docs.jamf.com') || url.includes('learn.jamf.com'), 'URL must be from docs.jamf.com or learn.jamf.com')
+        .describe('Full URL of the Jamf documentation article'),
+    section: z.string()
+        .optional()
+        .describe('Extract only a specific section by title or ID (e.g., "Prerequisites", "Configuration")'),
+    includeRelated: z.boolean()
+        .default(false)
+        .describe('Include related article links in the response'),
+    maxTokens: MaxTokensSchema
+        .optional()
+        .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    responseFormat: ResponseFormatSchema
+        .default(ResponseFormat.MARKDOWN)
+        .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
+}).strict();
+/**
+ * Schema for jamf_docs_get_toc
+ */
+export const GetTocInputSchema = z.object({
+    product: z.enum(productIds)
+        .describe('Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect'),
+    version: z.string()
+        .optional()
+        .describe('Specific version (defaults to latest)'),
+    page: PageSchema
+        .optional()
+        .describe(`Page number for pagination (1-${PAGINATION_CONFIG.MAX_PAGE}, default: 1)`),
+    maxTokens: MaxTokensSchema
+        .optional()
+        .describe(`Maximum tokens in response (${TOKEN_CONFIG.MIN_TOKENS}-${TOKEN_CONFIG.MAX_TOKENS_LIMIT}, default: ${TOKEN_CONFIG.DEFAULT_MAX_TOKENS})`),
+    responseFormat: ResponseFormatSchema
+        .default(ResponseFormat.MARKDOWN)
+        .describe('Output format: "markdown" for human-readable or "json" for machine-readable')
+}).strict();
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/services/cache.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Caching service for Jamf documentation
+ *
+ * Provides file-based caching with TTL support
+ */
+/**
+ * File-based cache implementation
+ */
+declare class FileCache {
+    private cacheDir;
+    private memoryCache;
+    constructor(cacheDir?: string);
+    /**
+     * Generate a cache key hash
+     */
+    private getCacheKey;
+    /**
+     * Get the file path for a cache key
+     */
+    private getCachePath;
+    /**
+     * Ensure cache directory exists
+     */
+    private ensureCacheDir;
+    /**
+     * Get a value from cache
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value in cache
+     */
+    set<T>(key: string, data: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a cache entry
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    stats(): Promise<{
+        memoryEntries: number;
+        fileEntries: number;
+        totalSize: number;
+    }>;
+    /**
+     * Prune expired entries
+     */
+    prune(): Promise<number>;
+}
+export declare const cache: FileCache;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/services/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA+C;gBAEtD,QAAQ,GAAE,MAAkB;IAIxC;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,cAAc;IAQ5B;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiC5C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAE,MAAkC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1F;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBzF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAmC/B;AAGD,eAAO,MAAM,KAAK,WAAkB,CAAC"}