{"_id":"azure-policy-mcp","_rev":"4-20fe7f49723f92aba81cfe89fff15a24","name":"azure-policy-mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"azure-policy-mcp","version":"1.0.0","keywords":["mcp","azure","bicep","policy","infrastructure","compliance","code-generation","modelcontextprotocol","claude","ai"],"author":{"url":"https://github.com/andrewlwn77/azure-policy-mcp","name":"andrewlwn77"},"license":"MIT","_id":"azure-policy-mcp@1.0.0","maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"homepage":"https://github.com/andrewlwn77/azure-policy-mcp#readme","bugs":{"url":"https://github.com/andrewlwn77/azure-policy-mcp/issues"},"bin":{"azure-policy-mcp":"build/index.js"},"dist":{"shasum":"6fb09e728b2f3ad66e1093b24d5c19f9cef57639","tarball":"https://registry.npmjs.org/azure-policy-mcp/-/azure-policy-mcp-1.0.0.tgz","fileCount":32,"integrity":"sha512-vbJ9/4Cfui4EyklUqnQeSP+OCVMCZ3uD4o3cwKVe7cDeWHFxGuFun8/Sr1MAKqMBwfNab8QFcstSMNr311PvvA==","signatures":[{"sig":"MEUCIEtWtKVdB2GBf3JACHBA2jAk33Q+sBOnXUbjo//fnd/CAiEA+bybX0+AfvyZwCfpzTN6oPkY/0Sn9IG+HLsSHIqMwg4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107352},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e7431cc7f013e20b81f712859d58f458c64fe1e2","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"npm run build && npm run test:compile && jest","build":"tsc","start":"node ./build/index.js","pretest":"","lint:fix":"eslint src --ext .ts --fix","test:unit":"npm run build && npm run test:compile && jest tests/unit","test:watch":"npm run build && npm run test:compile && jest --watch","postversion":"git push && git push --tags","test:compile":"tsc --project tsconfig.test.json","test:coverage":"npm run build && npm run test:compile && jest --coverage","prepublishOnly":"npm run build","test:integration":"npm run build && npm run test:compile && jest tests/integration"},"_npmUser":{"name":"andrewlwn77","email":"andrewlwn@gmail.com"},"repository":{"url":"git+https://github.com/andrewlwn77/azure-policy-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for generating policy-compliant Azure Bicep infrastructure from natural language descriptions","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.25.76","typescript":"^5.8.3","@modelcontextprotocol/sdk":"^1.15.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.0.4","eslint":"^8.57.0","ts-jest":"^29.4.0","@types/jest":"^30.0.0","@types/node":"^20.19.8","@jest/globals":"^30.0.4","@typescript-eslint/parser":"^8.0.0","@typescript-eslint/eslint-plugin":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/azure-policy-mcp_1.0.0_1754585451568_0.2830381341829058","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"azure-policy-mcp","version":"1.1.0","keywords":["mcp","azure","bicep","policy","infrastructure","compliance","code-generation","modelcontextprotocol","claude","ai"],"author":{"url":"https://github.com/andrewlwn77/azure-policy-mcp","name":"andrewlwn77"},"license":"MIT","_id":"azure-policy-mcp@1.1.0","maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"homepage":"https://github.com/andrewlwn77/azure-policy-mcp#readme","bugs":{"url":"https://github.com/andrewlwn77/azure-policy-mcp/issues"},"bin":{"azure-policy-mcp":"build/index.js"},"dist":{"shasum":"85bcec4c4f55758043007e0b0bb54e45189a923a","tarball":"https://registry.npmjs.org/azure-policy-mcp/-/azure-policy-mcp-1.1.0.tgz","fileCount":32,"integrity":"sha512-qZhPV4KmSRXme0G77gKHMF0tgCLJ11fx2hamjRVa49nmSaXtHZ2v2JsCtHjetpUC62kszipxKf7PA05XjiTXgQ==","signatures":[{"sig":"MEQCIHpXLbPx7QKI8vmPWd/dnFIZJqxLKHUm9EEM0iw8H+vGAiBsuGV//pJwTY5dnb29zcIleVKznilRVBouAKPay4/Crg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":114601},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e7431cc7f013e20b81f712859d58f458c64fe1e2","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"npm run build && npm run test:compile && jest","build":"tsc","start":"node ./build/index.js","pretest":"","lint:fix":"eslint src --ext .ts --fix","test:unit":"npm run build && npm run test:compile && jest tests/unit","test:watch":"npm run build && npm run test:compile && jest --watch","postversion":"git push && git push --tags","test:compile":"tsc --project tsconfig.test.json","test:coverage":"npm run build && npm run test:compile && jest --coverage","prepublishOnly":"npm run build","test:integration":"npm run build && npm run test:compile && jest tests/integration"},"_npmUser":{"name":"andrewlwn77","email":"andrewlwn@gmail.com"},"repository":{"url":"git+https://github.com/andrewlwn77/azure-policy-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for generating policy-compliant Azure Bicep infrastructure from natural language descriptions","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.25.76","typescript":"^5.8.3","@modelcontextprotocol/sdk":"^1.15.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.0.4","eslint":"^8.57.0","ts-jest":"^29.4.0","@types/jest":"^30.0.0","@types/node":"^20.19.8","@jest/globals":"^30.0.4","@typescript-eslint/parser":"^8.0.0","@typescript-eslint/eslint-plugin":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/azure-policy-mcp_1.1.0_1754688971775_0.7978647691888661","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"azure-policy-mcp","version":"1.2.0","keywords":["mcp","azure","bicep","policy","infrastructure","compliance","code-generation","modelcontextprotocol","claude","ai"],"author":{"url":"https://github.com/andrewlwn77/azure-policy-mcp","name":"andrewlwn77"},"license":"MIT","_id":"azure-policy-mcp@1.2.0","maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"homepage":"https://github.com/andrewlwn77/azure-policy-mcp#readme","bugs":{"url":"https://github.com/andrewlwn77/azure-policy-mcp/issues"},"bin":{"azure-policy-mcp":"build/index.js"},"dist":{"shasum":"16b2a3024ae3cf811e39536f0f901af584268579","tarball":"https://registry.npmjs.org/azure-policy-mcp/-/azure-policy-mcp-1.2.0.tgz","fileCount":36,"integrity":"sha512-IKWVxbJBTUEYRCWrTOLY6QOxLxCmP1AVVn/j7fhsjRlepyaaFUUeP9rkxif79hvmPksZD+8PiGOy9EbLfBQRSA==","signatures":[{"sig":"MEYCIQClysNsDJeHSFNxS5DvG977xjcPMht62Y0NCoKlBqziYwIhANwoZ4KNdyNFV7xI6OODFBlndYzCtZCgk7yOKCwP5/Py","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":152436},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"732777b9c82481a9d3bf06c3f1909f68d40e7234","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts","test":"npm run build && npm run test:compile && jest","build":"tsc","start":"node ./build/index.js","pretest":"","lint:fix":"eslint src --ext .ts --fix","test:unit":"npm run build && npm run test:compile && jest tests/unit","test:watch":"npm run build && npm run test:compile && jest --watch","postversion":"git push && git push --tags","test:compile":"tsc --project tsconfig.test.json","test:coverage":"npm run build && npm run test:compile && jest --coverage","prepublishOnly":"npm run build","test:integration":"npm run build && npm run test:compile && jest tests/integration"},"_npmUser":{"name":"andrewlwn77","email":"andrewlwn@gmail.com"},"repository":{"url":"git+https://github.com/andrewlwn77/azure-policy-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for generating policy-compliant Azure Bicep infrastructure from natural language descriptions","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.25.76","typescript":"^5.8.3","@modelcontextprotocol/sdk":"^1.15.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.0.4","eslint":"^8.57.0","ts-jest":"^29.4.0","@types/jest":"^30.0.0","@types/node":"^20.19.8","@jest/globals":"^30.0.4","@typescript-eslint/parser":"^8.0.0","@typescript-eslint/eslint-plugin":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/azure-policy-mcp_1.2.0_1755115401586_0.4671090144633172","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"azure-policy-mcp","version":"1.3.0","description":"MCP server for generating policy-compliant Azure Bicep infrastructure from natural language descriptions","main":"build/index.js","type":"module","bin":{"azure-policy-mcp":"build/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node ./build/index.js","test":"npm run build && npm run test:compile && jest","test:compile":"tsc --project tsconfig.test.json","test:unit":"npm run build && npm run test:compile && jest tests/unit","test:integration":"npm run build && npm run test:compile && jest tests/integration","test:watch":"npm run build && npm run test:compile && jest --watch","test:coverage":"npm run build && npm run test:compile && jest --coverage","lint":"eslint src --ext .ts","lint:fix":"eslint src --ext .ts --fix","pretest":"","prepublishOnly":"npm run build","postversion":"git push && git push --tags"},"keywords":["mcp","azure","bicep","policy","infrastructure","compliance","code-generation","modelcontextprotocol","claude","ai"],"author":{"name":"andrewlwn77","url":"https://github.com/andrewlwn77/azure-policy-mcp"},"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.15.1","puppeteer":"^21.0.0","typescript":"^5.8.3","zod":"^3.25.76"},"devDependencies":{"@jest/globals":"^30.0.4","@types/jest":"^30.0.0","@types/node":"^20.19.8","@typescript-eslint/eslint-plugin":"^8.0.0","@typescript-eslint/parser":"^8.0.0","eslint":"^8.57.0","jest":"^30.0.4","ts-jest":"^29.4.0"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/andrewlwn77/azure-policy-mcp.git"},"bugs":{"url":"https://github.com/andrewlwn77/azure-policy-mcp/issues"},"homepage":"https://github.com/andrewlwn77/azure-policy-mcp#readme","_id":"azure-policy-mcp@1.3.0","gitHead":"732777b9c82481a9d3bf06c3f1909f68d40e7234","types":"./build/index.d.ts","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-jLJm/N7o06j//2NAf/YglmwLvIZdqVHlVzy6mN4M5CYpWGGHfzlCZEfjbY4jx7Coq8glqt6e1MzqZ/eIKiiF0w==","shasum":"3299c00bd66bef8bbaa8414deabf2eaf8babe81a","tarball":"https://registry.npmjs.org/azure-policy-mcp/-/azure-policy-mcp-1.3.0.tgz","fileCount":36,"unpackedSize":178375,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHhYncO9NCNME4FiryZEIsr/Aop7A1POjRxdJ6+1OwqsAiEAhJjAKcyr/+eqR+2/O17S/u681QOQV7Hhh5eNdBhaMxQ="}]},"_npmUser":{"name":"andrewlwn77","email":"andrewlwn@gmail.com"},"directories":{},"maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/azure-policy-mcp_1.3.0_1755129405907_0.5485195024068936"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-07T16:50:51.483Z","modified":"2025-08-13T23:56:46.594Z","1.0.0":"2025-08-07T16:50:51.772Z","1.1.0":"2025-08-08T21:36:11.969Z","1.2.0":"2025-08-13T20:03:21.788Z","1.3.0":"2025-08-13T23:56:46.103Z"},"bugs":{"url":"https://github.com/andrewlwn77/azure-policy-mcp/issues"},"author":{"name":"andrewlwn77","url":"https://github.com/andrewlwn77/azure-policy-mcp"},"license":"MIT","homepage":"https://github.com/andrewlwn77/azure-policy-mcp#readme","keywords":["mcp","azure","bicep","policy","infrastructure","compliance","code-generation","modelcontextprotocol","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/andrewlwn77/azure-policy-mcp.git"},"description":"MCP server for generating policy-compliant Azure Bicep infrastructure from natural language descriptions","maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"readme":"# Azure Policy MCP Server\n\nA Model Context Protocol (MCP) server that provides Azure policy analysis and Bicep template generation capabilities for Claude Code. Generate policy-compliant Azure infrastructure using natural language descriptions and GitHub Search API for fast, real-time results.\n\n## Overview\n\nThe Azure Policy MCP Server integrates Azure policy intelligence with Bicep template generation, enabling developers to:\n- Analyze Azure policies applicable to specific resource types\n- Generate policy-compliant Bicep templates from natural language\n- Validate existing templates against Azure policies  \n- Search Azure QuickStart templates efficiently\n- Get policy compliance recommendations\n- Scrape live Azure resource documentation from Microsoft Learn\n\nBuilt with GitHub Search API for fast responses and real-time data access.\n\n## Features\n\n### 🧠 **Intelligent Infrastructure Generation**\n- Generate policy-compliant Bicep code from natural language descriptions\n- Context-aware template customization for specific environments and requirements\n- Automated compliance validation and explanatory documentation\n\n### 📋 **Policy Intelligence**\n- Discover and analyze applicable Azure policies for any resource type\n- Human-readable policy explanations with compliance guidance\n- Policy requirement translation to specific technical configurations\n\n### ✅ **Template Validation & Remediation**\n- Comprehensive policy validation of existing Bicep templates\n- Automated fix generation for policy violations\n- Multi-option remediation with trade-off analysis\n\n### 🔍 **Smart Template Discovery**\n- Search 1000+ proven compliant templates from comprehensive database\n- Relevance ranking and compliance quality assessment\n- Template customization guidance and real-time validation\n\n### 📖 **Progressive Documentation Access**\n- **Two-function architecture** for optimal user experience without information overload\n- **Quick Overview**: Fast metadata extraction (property counts, complexity assessment, available sections)\n- **Selective Retrieval**: Get only the sections you need (properties, code examples, API versions, quick summary)\n- **Real-time scraping** from Microsoft Learn with Bicep, ARM, and Terraform support\n- **Smart caching** with configurable duration up to 24 hours\n\n## Installation\n\n### Method 1: NPX (Recommended)\n\nAdd the following to your Claude Code `.mcp.json` configuration file:\n\n```json\n{\n  \"azure-policy-mcp\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"azure-policy-mcp\"],\n    \"transport\": {\"type\": \"stdio\"},\n    \"env\": {\n      \"NODE_ENV\": \"production\",\n      \"GITHUB_TOKEN\": \"your_github_token_here\"\n    },\n    \"disabled\": false,\n    \"autoApprove\": [],\n    \"description\": \"Azure Policy MCP Server - Generate policy-compliant Bicep templates from natural language\"\n  }\n}\n```\n\n### Method 2: Global NPM Installation\n\n```bash\nnpm install -g azure-policy-mcp\n```\n\nThen add to your `.mcp.json` configuration:\n```json\n{\n  \"azure-policy-mcp\": {\n    \"command\": \"azure-policy-mcp\",\n    \"transport\": {\"type\": \"stdio\"},\n    \"env\": {\n      \"GITHUB_TOKEN\": \"your_github_token_here\"\n    }\n  }\n}\n```\n\n### GitHub Token Setup\n\nFor best performance, add a GitHub personal access token:\n\n1. Go to GitHub Settings → Developer settings → Personal access tokens\n2. Generate a token with `public_repo` access\n3. Add it to your MCP configuration as shown above\n\nWithout a token, you'll be limited to 60 API requests per hour.\n\n## Usage\n\nOnce installed, the Azure Policy MCP integrates seamlessly with Claude Code. Use natural language commands:\n\n```\n\"Create a secure storage account for healthcare data\"\n\"What policies apply to virtual machines in my subscription?\"\n\"Validate this Bicep template against Azure policies\"\n\"Fix policy violations in my infrastructure template\"\n\"Get overview of Azure Key Vault documentation\"\n\"Show me only the properties for Azure App Service\"\n\"Get Bicep examples and API versions for Storage Accounts\"\n```\n\n## Available MCP Tools\n\n### `analyze_policy_requirements`\nAnalyze Azure policies applicable to specific resource types and provide compliance guidance.\n\n**Parameters:**\n- `resource_types` (required): Array of Azure resource types (e.g., `[\"Microsoft.Storage/storageAccounts\"]`)\n- `policy_categories` (optional): Filter by policy categories (e.g., `[\"Security\", \"Compliance\"]`)\n- `include_deprecated` (optional): Include deprecated policies (default: false)\n\n### `validate_bicep_against_policies`\nValidate Bicep template against Azure policies and identify compliance issues.\n\n**Parameters:**\n- `bicep_content` (required): Bicep template content to validate\n- `policy_categories` (optional): Policy categories to validate against\n\n### `search_bicep_templates`\nSearch Azure Bicep templates by resource types, categories, and keywords.\n\n**Parameters:**\n- `resource_types` (optional): Resource types to search for\n- `categories` (optional): Template categories (Compute, Storage, Network, etc.)\n- `keywords` (optional): Keywords to search in template names\n- `max_complexity` (optional): Maximum template complexity (simple, moderate, complex)\n- `limit` (optional): Maximum number of results (default: 10)\n\n### `recommend_bicep_templates`\nGet template recommendations based on requirements and generate policy-compliant Bicep code.\n\n**Parameters:**\n- `requirements` (required): Natural language description of infrastructure needs\n- `resource_types` (optional): Specific Azure resource types needed\n- `include_monitoring` (optional): Include monitoring and diagnostics (default: true)\n- `include_security` (optional): Include security best practices (default: true)\n\n### `fetch_azure_documentation_overview`\nGet a lightweight overview of Azure resource documentation for quick assessment without information overload.\n\n**Parameters:**\n- `resource_type` (required): Azure resource type (e.g., `\"Microsoft.Storage/storageAccounts\"`)\n- `cache_duration` (optional): Cache duration in minutes (default: 60, max: 1440)\n\n**Returns:**\n- Property count and complexity assessment\n- Number of available code examples and API versions\n- List of available sections for detailed retrieval\n- Fast response time (~1-2 seconds)\n\n### `fetch_azure_documentation_details`\nGet detailed Azure resource documentation with selective section retrieval to avoid overwhelming users.\n\n**Parameters:**\n- `resource_type` (required): Azure resource type (e.g., `\"Microsoft.Storage/storageAccounts\"`)\n- `sections` (optional): Array of sections to retrieve - `[\"properties\", \"code_examples\", \"api_versions\", \"quick_summary\"]` (default: all)\n- `language` (optional): Documentation language preference - `\"bicep\"`, `\"arm\"`, or `\"terraform\"` (default: `\"bicep\"`)\n- `include_examples` (optional): Include code examples in response (default: `true`)\n- `cache_duration` (optional): Cache duration in minutes (default: 60, max: 1440)\n\n**Example Usage:**\n```\n\"Get overview of Azure Storage Account documentation\"\n\"Show me just the API versions for Virtual Machines\"\n\"Get properties and code examples for Azure Key Vault\"\n\"Fetch only Bicep examples for App Service\"\n```\n\n### `refresh_data_sources`\nRefresh cached data from GitHub repositories.\n\n**Parameters:**\n- `data_source` (optional): Specific data source to refresh\n\n## Data Sources\n\nThe MCP server uses GitHub Search API to access real-time data from:\n\n- **Azure Policy Repository** (`Azure/azure-policy`): Official Azure policy definitions\n- **Azure QuickStart Templates** (`Azure/azure-quickstart-templates`): Community-driven Bicep templates\n- **Live GitHub Search**: Real-time search across Azure repositories\n- **Microsoft Learn Documentation** (`learn.microsoft.com`): Live Azure resource documentation scraping\n\n## Configuration\n\n### Environment Variables\n\n- `GITHUB_TOKEN`: GitHub API token for higher rate limits (recommended)\n- `PUPPETEER_EXECUTABLE_PATH`: Custom path to Chrome executable for documentation scraping (optional)\n- `CACHE_SIZE_MB`: Maximum cache size in megabytes (default: 256)\n- `LOG_LEVEL`: Logging level - error, warn, info, debug (default: info)\n- `NODE_ENV`: Node environment (default: production)\n\n### Performance\n\n- **Policy Analysis**: < 2 seconds (with GitHub Search API)\n- **Template Search**: < 2 seconds (direct directory search)\n- **Template Validation**: < 3 seconds (cached policy lookups)\n- **Code Generation**: < 1 second (template-based generation)\n- **Documentation Overview**: 1-2 seconds (fast metadata extraction)\n- **Documentation Details**: 3-5 seconds (selective content retrieval)\n\n### Rate Limits\n\n- **With GitHub Token**: 30 searches/minute, 5000 API requests/hour\n- **Without Token**: 10 searches/minute, 60 API requests/hour\n\n## Development\n\n### Prerequisites\n- Node.js 18+\n- TypeScript 5.0+\n- GitHub access for fetching templates and policies\n\n### Setup\n```bash\ngit clone https://github.com/andrewlwn77/azure-policy-mcp.git\ncd azure-policy-mcp\nnpm install\nnpm run build\n```\n\n### Testing\n```bash\nnpm test                # Run all tests\nnpm run test:unit      # Run unit tests\nnpm run test:integration # Run integration tests\nnpm run test:coverage   # Run with coverage\n```\n\n### Building\n```bash\nnpm run build     # Compile TypeScript\nnpm run dev       # Watch mode for development\n```\n\n## Architecture\n\nThe Azure Policy MCP follows a lightweight, API-first architecture:\n\n```\nsrc/\n├── server/            # MCP server and tool implementations\n├── services/          # GitHub API integration and parsing\n├── infrastructure/    # Caching, session management, error handling\n└── types/             # TypeScript definitions\n```\n\n### Key Components\n\n- **GitHub Search API Integration**: Fast, real-time policy and template discovery\n- **Direct File Fetching**: Targeted file access without heavy indexing\n- **Progressive Documentation System**: Two-function architecture preventing information overload\n- **Puppeteer Browser Automation**: Direct Microsoft Learn documentation scraping\n- **Intelligent Caching**: Separate cache strategies for overview and detailed content\n- **Policy Parser**: JSON policy definition analysis and explanation\n- **Template Generator**: Policy-compliant Bicep code generation\n- **Timeout Management**: 10-30 second timeouts preventing hanging requests\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes with tests\n4. Run the test suite\n5. Submit a pull request\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Publishing\n\nTo publish to npm:\n\n```bash\nnpm version patch  # or minor, major\nnpm publish\n```\n\n**Note**: Publishing requires OTP (One-Time Password) authentication.\n\n## Support\n\nFor issues and questions:\n- **GitHub Issues**: [https://github.com/andrewlwn77/azure-policy-mcp/issues](https://github.com/andrewlwn77/azure-policy-mcp/issues)\n- **GitHub Repository**: [https://github.com/andrewlwn77/azure-policy-mcp](https://github.com/andrewlwn77/azure-policy-mcp)\n\n---\n\nBuilt with the BMAD Method for comprehensive, production-ready software development.","readmeFilename":"README.md"}