{"_id":"@eevenson/architect-knowledge-mcp","_rev":"2-03c9cc710750ab4f11b75929387f0839","name":"@eevenson/architect-knowledge-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@eevenson/architect-knowledge-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","cloud-architecture","knowledge-base","checklists","compliance","infrastructure"],"author":{"name":"Erik Evenson"},"license":"MIT","_id":"@eevenson/architect-knowledge-mcp@0.1.0","maintainers":[{"name":"eevenson","email":"erik.e.evenson@gmail.com"}],"homepage":"https://github.com/ErikEvenson/architect-knowledge-mcp#readme","bugs":{"url":"https://github.com/ErikEvenson/architect-knowledge-mcp/issues"},"bin":{"architect-knowledge-mcp":"build/index.js"},"dist":{"shasum":"3f4bfd57de34efae6622f6eabe43882ecf41629d","tarball":"https://registry.npmjs.org/@eevenson/architect-knowledge-mcp/-/architect-knowledge-mcp-0.1.0.tgz","fileCount":15,"integrity":"sha512-y8Axw/0XcefAfl77fROvpiJZdDSh1ANNl1d5P6jjNAPn8BGJJ/mqqzzQ97AdWgw98xjxd7Cd3uIqzKuG82raaQ==","signatures":[{"sig":"MEQCIEDsZSiWZ79o7V77nVtcanjNZ4NsukZ5/8nI5Vm1gTH/AiAE8FdE6SGMqcoVAm9OlRrvNyAwO9cqSVEmAGo3cxZjkQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46762},"type":"module","engines":{"node":">=18"},"gitHead":"29724a25a520f37762afa67baf360ce9b1ca498e","scripts":{"test":"node --test build/test.js","build":"tsc && chmod 755 build/index.js","prepare":"npm run build"},"_npmUser":{"name":"eevenson","email":"erik.e.evenson@gmail.com"},"repository":{"url":"git+https://github.com/ErikEvenson/architect-knowledge-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for the Architect knowledge library — cloud architecture checklists, vendor guidance, and compliance frameworks","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","minisearch":"^7.1.1","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/architect-knowledge-mcp_0.1.0_1774559742654_0.12978963189797765","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@eevenson/architect-knowledge-mcp","version":"0.1.1","description":"MCP server for the Architect knowledge library — cloud architecture checklists, vendor guidance, and compliance frameworks","type":"module","bin":{"architect-knowledge-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod 755 build/index.js","prepare":"npm run build","test":"node --test build/test.js"},"keywords":["mcp","model-context-protocol","cloud-architecture","knowledge-base","checklists","compliance","infrastructure"],"author":{"name":"Erik Evenson"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ErikEvenson/architect-knowledge-mcp.git"},"homepage":"https://github.com/ErikEvenson/architect-knowledge-mcp#readme","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","minisearch":"^7.1.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"_id":"@eevenson/architect-knowledge-mcp@0.1.1","gitHead":"59a5ec849cdca7d47f798e98b12135e3e711831f","bugs":{"url":"https://github.com/ErikEvenson/architect-knowledge-mcp/issues"},"_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-ep5rz1wyUYaYg+KN9/ilCbPbPPKLdFHpFUuGjUKORqvQl4I1H3ucKrhCnN8lMCtvkU0gf5KJGylyOPIYS79Rdw==","shasum":"1897fc3f563d1b7c7b98774df7d670d732448e43","tarball":"https://registry.npmjs.org/@eevenson/architect-knowledge-mcp/-/architect-knowledge-mcp-0.1.1.tgz","fileCount":15,"unpackedSize":55370,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH/t/nB0+Dw0EQWi2e1TPhRZVwhGDmF+QRJc250nXe1HAiEAgUCGKqUJx1PTUQreEaxqrvI4njOoUUWForsskVB85gs="}]},"_npmUser":{"name":"eevenson","email":"erik.e.evenson@gmail.com"},"directories":{},"maintainers":[{"name":"eevenson","email":"erik.e.evenson@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/architect-knowledge-mcp_0.1.1_1775598236611_0.42335267690519585"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-26T21:15:42.523Z","modified":"2026-04-07T21:43:56.875Z","0.1.0":"2026-03-26T21:15:42.811Z","0.1.1":"2026-04-07T21:43:56.769Z"},"bugs":{"url":"https://github.com/ErikEvenson/architect-knowledge-mcp/issues"},"author":{"name":"Erik Evenson"},"license":"MIT","homepage":"https://github.com/ErikEvenson/architect-knowledge-mcp#readme","keywords":["mcp","model-context-protocol","cloud-architecture","knowledge-base","checklists","compliance","infrastructure"],"repository":{"type":"git","url":"git+https://github.com/ErikEvenson/architect-knowledge-mcp.git"},"description":"MCP server for the Architect knowledge library — cloud architecture checklists, vendor guidance, and compliance frameworks","maintainers":[{"name":"eevenson","email":"erik.e.evenson@gmail.com"}],"readme":"# Architect Knowledge MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@eevenson/architect-knowledge-mcp)](https://www.npmjs.com/package/@eevenson/architect-knowledge-mcp)\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that provides cloud architecture guidance from a curated knowledge library. Use it with Claude Desktop, Claude Code, Cursor, or any MCP-compatible client to get specific, checklist-driven architecture advice.\n\n## What's in the knowledge library?\n\n- **330+ curated files** covering cloud architecture best practices\n- **Providers:** AWS, Azure, GCP, Kubernetes, VMware, Nutanix, Cisco, Dell, HPE, NetApp, Pure Storage, Snowflake, Databricks, Confluent/Kafka, MongoDB, Redis, Elasticsearch, CrowdStrike, Okta, GitLab, ArgoCD, and 40+ more\n- **Compliance:** HIPAA, PCI-DSS, SOC2, FedRAMP, GDPR, CCPA, CJIS, ITAR, ISO 27001, NIST/CMMC, and more\n- **Patterns:** Microservices, hybrid cloud, edge computing, AI/ML infrastructure, application modernization, security operations, migration patterns\n- **General:** Networking, compute, storage, identity, observability, disaster recovery, cost management, messaging, supply chain security, performance testing\n- **Checklists:** Every item tagged `[Critical]`, `[Recommended]`, or `[Optional]`\n\nThe knowledge library is sourced from the public [ErikEvenson/architect](https://github.com/ErikEvenson/architect) repository. No client data, project files, or private content is included.\n\n## Setup\n\n### Claude Desktop\n\nAdd to your Claude Desktop config file (or use **Settings > Developer > Edit Config**):\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"architect-knowledge\": {\n      \"command\": \"npx\",\n      \"args\": [\"@eevenson/architect-knowledge-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. A hammer icon will appear at the bottom of the chat input when the tools are available.\n\n### Claude Code\n\nRun this from the Claude Code prompt:\n\n```\nclaude mcp add architect-knowledge -- npx @eevenson/architect-knowledge-mcp\n```\n\nOr add to your settings JSON:\n\n```json\n{\n  \"mcpServers\": {\n    \"architect-knowledge\": {\n      \"command\": \"npx\",\n      \"args\": [\"@eevenson/architect-knowledge-mcp\"]\n    }\n  }\n}\n```\n\n### LM Studio\n\nRequires LM Studio 0.3.17+. Go to **Program tab > Install > Edit mcp.json** and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"architect-knowledge\": {\n      \"command\": \"npx\",\n      \"args\": [\"@eevenson/architect-knowledge-mcp\"]\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nWorks with any MCP-compatible client including Cursor, Windsurf, Cline, and Continue. Consult your client's documentation for how to add MCP servers.\n\n## Tools\n\n### `search_knowledge`\n\nSearch the knowledge library for checklists, vendor guidance, and design patterns.\n\n**Parameters:**\n- `query` (required) — Natural language search, e.g. \"VMware to Nutanix migration checklist\"\n- `top_k` (optional) — Max results, 1-50, default 20\n- `priority_filter` (optional) — `\"critical\"`, `\"recommended\"`, or `\"optional\"`\n- `file_filter` (optional) — Filter to a provider or category, e.g. `\"aws\"`, `\"compliance/hipaa\"`\n\n### `list_categories`\n\nBrowse available knowledge categories and files.\n\n**Parameters:**\n- `category` (optional) — Filter to a category, e.g. `\"providers/aws\"`, `\"compliance\"`\n\n### `read_file`\n\nRead a complete knowledge file.\n\n**Parameters:**\n- `path` (required) — File path, e.g. `\"providers/aws/containers.md\"`\n\n## Example Usage\n\nOnce connected, just ask architecture questions naturally:\n\n- \"What are the critical checklist items for HIPAA compliance?\"\n- \"Search for Kubernetes storage best practices\"\n- \"What should I consider for a VMware to Nutanix migration?\"\n- \"Show me the AWS containers checklist\"\n- \"What compliance frameworks cover encryption requirements?\"\n\nClaude will automatically call the MCP tools to ground its answers in the knowledge library's curated checklists.\n\n## How It Works\n\n1. On first run, fetches knowledge files from the public GitHub repo\n2. Caches files locally in `~/.cache/architect-knowledge-mcp/`\n3. On subsequent runs, checks if the cache is fresh (same commit SHA) — skips download if so\n4. Indexes all files using lightweight text search (BM25) for instant startup\n5. Exposes three MCP tools for searching, browsing, and reading\n\nNo embedding models, no GPUs, no external databases. The package is ~15KB and starts instantly after initial cache.\n\n## Data Safety\n\n- Only reads from the public `knowledge/` directory in the GitHub repo\n- Allowlisted directories only: `general`, `providers`, `patterns`, `compliance`, `frameworks`, `failures`\n- Never accesses client data, project uploads, or database content\n- Runs entirely on your machine — no data sent anywhere except to the LLM you're already using\n- No API keys required (optional `GITHUB_TOKEN` env var to avoid rate limits)\n\n## Development\n\n```bash\ngit clone https://github.com/ErikEvenson/architect-knowledge-mcp.git\ncd architect-knowledge-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n## Troubleshooting\n\n**Tools not showing in Claude Desktop?**\n- Restart Claude Desktop after editing the config\n- Check logs at `~/Library/Logs/Claude/mcp-server-architect-knowledge.log` (macOS)\n- Verify Node.js 18+ is installed: `node --version`\n\n**Slow first startup?**\n- The first run fetches ~330 files from GitHub (takes 15-30 seconds)\n- Subsequent runs use the local cache and start instantly\n\n**GitHub rate limiting?**\n- Set `GITHUB_TOKEN` environment variable with a personal access token (no scopes needed for public repos)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}