{"_id":"@darashenka/mcp-codex-keeper","_rev":"2-e69a67fb9c5f9b78f35f1725bb70c41e","name":"@darashenka/mcp-codex-keeper","dist-tags":{"latest":"2.1.2"},"versions":{"2.1.1":{"name":"@darashenka/mcp-codex-keeper","version":"2.1.1","keywords":["mcp","documentation","cline","sonnet","assistant","development","best-practices","darashenka","typescript"],"author":{"name":"darashenka"},"license":"MIT","_id":"@darashenka/mcp-codex-keeper@2.1.1","maintainers":[{"name":"darashenka","email":"npmjs@andrei.darashenka.com"}],"homepage":"https://github.com/darashenka/mcp-codex-keeper#readme","bugs":{"url":"https://github.com/darashenka/mcp-codex-keeper/issues"},"bin":{"mcp-codex-keeper":"tsc && build/index.js"},"dist":{"shasum":"a9aae1764f4ff459dd754ef6a9011dddb506b007","tarball":"https://registry.npmjs.org/@darashenka/mcp-codex-keeper/-/mcp-codex-keeper-2.1.1.tgz","fileCount":77,"integrity":"sha512-OCLjGX8kKXTiGc48pIkCc5GVz5vJQKakk/CPvbTKqMdfLuA2PovLrEacvZxg9Vom/8hyfU5vpGDi4t6b/TkQDA==","signatures":[{"sig":"MEQCIBUrpYvLXJRsYgsY33y13DLm95PwEYKCNp2EpREL1iViAiA1aqr+gR/XuIJlaED+G2Faqw2Vyw3YUhNJ1o7vj2TVhQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":256397},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"ae6a8d4fb7ca9be9d89c6e7309f17734546741c2","scripts":{"dev":"tsc -w","build":"tsc && chmod +x build/index.js","local":"cross-env NODE_OPTIONS='--max-old-space-size=256' MCP_ENV=local npm_config_cache_max=1024000000 node build/index.js","start":"cross-env NODE_OPTIONS='--max-old-space-size=256' npm_config_cache_max=1024000000 node build/index.js","deploy":"npm run build && git add . && git commit -m \"chore: prepare for release\" && npm version patch && npm publish --access public && git push --tags && git push","version":"npm run update-version && git add -A","postversion":"git push && git push --tags","prepublishOnly":"npm run build","update-version":"node scripts/update-version.js"},"_npmUser":{"name":"darashenka","email":"npmjs@andrei.darashenka.com"},"repository":{"url":"git+https://github.com/darashenka/mcp-codex-keeper.git","type":"git"},"_npmVersion":"10.9.3","description":"An intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices","directories":{},"_nodeVersion":"22.19.0","dependencies":{"axios":"^1.7.9","isexe":"^3.1.1","fs-extra":"^11.2.0","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"cross-env":"^7.0.3","typescript":"^5.3.3","@types/node":"^20.17.12","@types/fs-extra":"^11.0.4"},"_npmOperationalInternal":{"tmp":"tmp/mcp-codex-keeper_2.1.1_1762449983177_0.9771717313216979","host":"s3://npm-registry-packages-npm-production"}},"2.1.2":{"name":"@darashenka/mcp-codex-keeper","version":"2.1.2","description":"An intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices","type":"module","main":"build/index.js","bin":{"mcp-codex-keeper":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","start":"cross-env NODE_OPTIONS='--max-old-space-size=256' npm_config_cache_max=1024000000 node build/index.js","dev":"tsc -w","prepublishOnly":"npm run build","local":"cross-env NODE_OPTIONS='--max-old-space-size=256' MCP_ENV=local npm_config_cache_max=1024000000 node build/index.js","update-version":"node scripts/update-version.js","version":"npm run update-version && git add -A","postversion":"git push && git push --tags","deploy":"npm run build && git add . && git commit -m \"chore: prepare for release\" && npm version patch && npm publish --access public && git push --tags && git push"},"keywords":["mcp","documentation","cline","sonnet","assistant","development","best-practices","darashenka","typescript"],"author":{"name":"darashenka"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"^1.7.9","fs-extra":"^11.2.0","isexe":"^3.1.1","node-fetch":"^3.3.2"},"devDependencies":{"@types/fs-extra":"^11.0.4","@types/node":"^20.17.12","cross-env":"^7.0.3","typescript":"^5.3.3"},"repository":{"type":"git","url":"git+https://github.com/darashenka/mcp-codex-keeper.git"},"bugs":{"url":"https://github.com/darashenka/mcp-codex-keeper/issues"},"homepage":"https://github.com/darashenka/mcp-codex-keeper#readme","engines":{"node":">=20.0.0"},"_id":"@darashenka/mcp-codex-keeper@2.1.2","gitHead":"6124ecc78f475e7788b246df1948fcbf12fcbb51","types":"./build/index.d.ts","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-O3bXSl17Jr2jYTz2Px1NjhO6QTYtUH2mdKaNNvbNgBLhe5HBfYSBWTUXGJfYeN15QWNk23g8MGTDjzE0xRf0aQ==","shasum":"423fb03bf1ab430b7f0a6201b992d99b2d97dfd7","tarball":"https://registry.npmjs.org/@darashenka/mcp-codex-keeper/-/mcp-codex-keeper-2.1.2.tgz","fileCount":77,"unpackedSize":256473,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDtrsqIEWrpIXq0TuVT6iCnNFFk6dPr8+xNq96E19ELkQIhAMowIcd/1Q0jnhg5Uof18z5rkbRRohVT1nUn6A2iGHkU"}]},"_npmUser":{"name":"darashenka","email":"npmjs@andrei.darashenka.com"},"directories":{},"maintainers":[{"name":"darashenka","email":"npmjs@andrei.darashenka.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-codex-keeper_2.1.2_1762450329787_0.4100817967889092"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-06T17:26:23.067Z","modified":"2025-11-06T17:32:10.204Z","2.1.1":"2025-11-06T17:26:23.407Z","2.1.2":"2025-11-06T17:32:09.992Z"},"bugs":{"url":"https://github.com/darashenka/mcp-codex-keeper/issues"},"author":{"name":"darashenka"},"license":"MIT","homepage":"https://github.com/darashenka/mcp-codex-keeper#readme","keywords":["mcp","documentation","cline","sonnet","assistant","development","best-practices","darashenka","typescript"],"repository":{"type":"git","url":"git+https://github.com/darashenka/mcp-codex-keeper.git"},"description":"An intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices","maintainers":[{"name":"darashenka","email":"npmjs@andrei.darashenka.com"}],"readme":"# Aindreyway MCP Codex Keeper\n\n![MCP Server](https://img.shields.io/badge/MCP-Server-blue)\n![Version](https://img.shields.io/badge/version-2.0.0-green)\n![License](https://img.shields.io/badge/license-MIT-blue)\n[![smithery badge](https://smithery.ai/badge/@aindreyway/mcp-codex-keeper)](https://smithery.ai/server/@aindreyway/mcp-codex-keeper)\n\nAn intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices.\n\n\"mcp-codex-keeper\n\n## 🚀 Quick Start\n\n### Installing via Smithery\n\nTo install Aindreyway Codex Keeper for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aindreyway/mcp-codex-keeper):\n\n```bash\nnpx -y @smithery/cli install @aindreyway/mcp-codex-keeper --client claude\n```\n\n### Prerequisites\n\n1. Make sure you have Node.js installed (version 18 or higher):\n\n ```bash\n node --version\n ```\n\n2. Install or update npm (comes with Node.js):\n\n ```bash\n npm install -g npm@latest\n ```\n\n3. Verify npx is available:\n ```bash\n npx --version\n ```\n If not found, install it:\n ```bash\n npm install -g npx\n ```\n\n### Configuration\n\nAdd this to your Cline/Sonnet configuration:\n\n```json\n\"aindreyway-codex-keeper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@aindreyway/mcp-codex-keeper@latest\"],\n \"disabled\": false,\n \"env\": {\n \"npm_config_cache_max\": \"1024000000\",\n \"NODE_OPTIONS\": \"--max-old-space-size=256\"\n }\n}\n```\n\nThat's it! The assistant will handle everything automatically.\n\n> **Note:** This server uses `npx` for direct npm package execution, which is optimal for Node.js/TypeScript MCP servers, providing seamless integration with the npm ecosystem and TypeScript tooling.\n\n## 🎯 What Your Assistant Can Do\n\nAsk your assistant to:\n\n- \"Show me the latest React documentation\"\n- \"Find best practices for TypeScript development\"\n- \"Update documentation for Node.js\"\n- \"Search for information about async/await\"\n\n## 🛠 Available Tools\n\n### list_documentation\n\nLists all available documentation sources with optional category filtering.\n\n### add_documentation\n\nAdd new documentation sources to the knowledge base.\n\n### update_documentation\n\nUpdate existing documentation to get the latest content.\n\n### search_documentation\n\nSearch through documentation with category filtering.\n\n## 📚 Documentation Categories\n\n- Frontend\n- Backend\n- Language\n- MCP\n- MCP-Guide\n- Database\n- DevOps\n- Security\n- Testing\n- Architecture\n- Mobile\n- AI\n- Cloud\n## 🔧 Features\n\nThe server automatically:\n\n- Manages documentation from various sources\n- Keeps track of latest development best practices\n- Provides intelligent search capabilities\n- Updates documentation automatically\n- Supports tagging and categorization\n- Optimizes memory usage:\n - Uses streaming for large files\n - Automatic cache cleanup\n - Memory-efficient search\n - Size and age limits for cached files\n - Limited heap size (256MB)\n\n## 🏗️ Architecture\n\nThe codebase follows a modular architecture with clear separation of concerns:\n\n- **Configuration**: Centralized configuration management\n- **Services**: Core business logic for documentation and search\n- **Handlers**: Request handlers for MCP tools and resources\n- **Utilities**: Reusable components for file system operations\n\nThis architecture makes the codebase more maintainable, testable, and extensible.\n - Limited heap size (256MB)\n\n## 📝 License\n\nMIT License - feel free to use this in your projects!\n\n## 👤 Author\n\n**aindreyway**\n\n- GitHub: [@aindreyway](https://github.com/aindreyway)\n\n## 📖 Documentation\n\n- [User Guide](README.md) - Installation and usage instructions\n- [Contributing Guide](CONTRIBUTING.md) - How to contribute to the project\n- [Technical Documentation](PROJECT_SUMMARY.md) - Detailed technical information\n- [Changelog](CHANGELOG.md) - Version history and changes\n\n## ⭐️ Support\n\nGive a ⭐️ if this project helped you! If you want to contribute, please check our [Contributing Guide](CONTRIBUTING.md).\n","readmeFilename":"README.md"}