{"_id":"@clancy_lee/mcp-id-generator","name":"@clancy_lee/mcp-id-generator","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@clancy_lee/mcp-id-generator","version":"0.1.0","description":"MCP server for generating IDs with different algorithms including Snowflake compatible with MyBatis-Plus","author":{"name":"Clancy Lee","email":"clancylee.818@gmail.com"},"license":"MIT","type":"module","main":"build/index.js","bin":{"id-generator":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build","prepublishOnly":"npm run build","prepack":"npm run build","test":"npm run build && cd tests && node test-mcp.js","test:snowflake":"npm run build && cd tests && node test-snowflake.js","test:compatibility":"npm run build && cd tests && node test-mybatis-plus-compatibility.js","test:external":"npm run build && cd tests && node test-external-call.js","test:all":"npm run test && npm run test:snowflake && npm run test:compatibility","release:patch":"npm version patch && npm publish","release:minor":"npm version minor && npm publish","release:major":"npm version major && npm publish"},"keywords":["mcp","id","generator","cuid2","uuid","nanoid","ulid","snowflake","distributed-id","mybatis-plus","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/liqiongchao/mcp-id-generator.git"},"homepage":"https://github.com/liqiongchao/mcp-id-generator#readme","bugs":{"url":"https://github.com/liqiongchao/mcp-id-generator/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","@paralleldrive/cuid2":"^2.2.2","@sapphire/snowflake":"^3.5.5","nanoid":"^5.1.5","ulid":"^3.0.0","uuid":"^11.1.0","zod":"^3.24.4"},"devDependencies":{"@types/node":"^22.15.3","typescript":"^5.8.3"},"_id":"@clancy_lee/mcp-id-generator@0.1.0","gitHead":"71c7445b33fcc48b977c599e3ef81bbc7cfbc45a","_nodeVersion":"24.2.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-Onjr4bSnxlWom6+S1OQjtcdjUIzb8X6wG3nHvf2rFqPh81A+IwCTAvVqHikFyWr49SCyu3tjyL1wQpWS9ZWRCQ==","shasum":"1abc8d78de5c579b7f1f5a659ae151b6ae26f600","tarball":"https://registry.npmjs.org/@clancy_lee/mcp-id-generator/-/mcp-id-generator-0.1.0.tgz","fileCount":4,"unpackedSize":8727,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIALCI9UOsLah33ySPXuIhj9THZZsJhwsISTiAGDpazhxAiEAnt4z7Z56GYht4/QsuEkYamF1gHVhOZeE4vSXkwJ7pqo="}]},"_npmUser":{"name":"clancy_lee","email":"clancylee.818@gmail.com"},"directories":{},"maintainers":[{"name":"clancy_lee","email":"clancylee.818@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-id-generator_0.1.0_1758706371120_0.11645459843197581"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-24T09:32:51.020Z","0.1.0":"2025-09-24T09:32:51.298Z","modified":"2025-09-24T09:32:51.562Z"},"maintainers":[{"name":"clancy_lee","email":"clancylee.818@gmail.com"}],"description":"MCP server for generating IDs with different algorithms including Snowflake compatible with MyBatis-Plus","homepage":"https://github.com/liqiongchao/mcp-id-generator#readme","keywords":["mcp","id","generator","cuid2","uuid","nanoid","ulid","snowflake","distributed-id","mybatis-plus","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/liqiongchao/mcp-id-generator.git"},"author":{"name":"Clancy Lee","email":"clancylee.818@gmail.com"},"bugs":{"url":"https://github.com/liqiongchao/mcp-id-generator/issues"},"license":"MIT","readme":"# ID Generator MCP\n\nThis is a Model Context Protocol (MCP) server that provides ID generation capabilities to AI assistants, including support for Snowflake algorithm compatible with MyBatis-Plus.\n\n## Installation\n\nThe ID Generator MCP can be integrated with various AI assistant platforms. Below are instructions for different environments:\n\n### Installing via npm\n\nTo install the ID Generator MCP via npm:\n\n```bash\nnpm install -g @clancy_lee/mcp-id-generator\n```\n\n### Local Installation\n\nFor local development or testing:\n\n```bash\ngit clone https://github.com/liqiongchao/mcp-id-generator.git\ncd mcp-id-generator\nnpm install\nnpm run build\n```\n\n### Installing via Smithery\n\nTo install ID Generator MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@devstacks-software-engineering/id-generator-mcp):\n\n```bash\nnpx -y @smithery/cli install @devstacks-software-engineering/id-generator-mcp --client claude\n```\n\n### Claude Code\n\nTo add the ID Generator MCP to Claude Code, run the following command:\n\n```bash\nclaude mcp add id-generator npx @clancy_lee/mcp-id-generator\n```\n\n### MCP Client Configuration\n\nTo add the ID Generator MCP to your MCP client, add the following configuration:\n\n#### Global Installation\n```json\n{\n  \"mcpServers\": {\n    \"id-generator\": {\n      \"command\": \"id-generator\",\n      \"args\": []\n    }\n  }\n}\n```\n\n#### NPX Installation  \n```json\n{\n  \"mcpServers\": {\n    \"id-generator\": {\n      \"command\": \"npx\",\n      \"args\": [\"@clancy_lee/mcp-id-generator\"]\n    }\n  }\n}\n```\n\n#### Local Development\n```json\n{\n  \"mcpServers\": {\n    \"id-generator\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-id-generator/build/index.js\"]\n    }\n  }\n}\n```\n\n## Usage\n\nOnce installed, the ID Generator MCP can be used by the AI assistant to generate various types of IDs.\n\n### Supported ID Algorithms\n\n| Algorithm | Example | Description |\n|-----------|---------|-------------|\n| `uuid` | `123e4567-e89b-12d3-a456-426614174000` | UUID v4 - Universally Unique Identifier that uses random numbers to generate a 128-bit value with extremely low collision probability. Standardized format widely used across many systems. |\n| `cuid2` | `clh3ppfqz0000jz0ggdlg7etk` | Collision-resistant IDs optimized for horizontal scaling and performance. Shorter than UUIDs while maintaining uniqueness. Designed to be secure, URL-safe, and sequential for database performance. |\n| `nanoid` | `V1StGXR8_Z5jdHi6B-myT` | Small, secure, URL-friendly unique string ID generator. Creates compact, non-sequential, URL-safe identifiers that are highly collision-resistant. Default length is 21 characters. |\n| `ulid` | `01ARZ3NDEKTSV4RRFFQ69G5FAV` | Universally Unique Lexicographically Sortable Identifier. Combines time-ordered uniqueness with random uniqueness. 26 characters, crockford base32 encoded (no special characters), URL-safe, and lexicographically sortable. |\n| `snowflake` | `1970773878481358848` | Snowflake algorithm ID - 64-bit integer providing global uniqueness with time-ordering. Designed for distributed systems, offers high performance and guaranteed uniqueness. Compatible with MyBatis-Plus using epoch starting from 2010-11-04. |\n\n## Features\n\n- Generate UUIDs (v4)\n- Create CUID2 IDs for collision-resistant identification\n- Generate Nanoid for compact, URL-friendly identifiers\n- Create ULIDs for time-ordered, sortable identifiers\n- Generate Snowflake IDs for distributed systems (MyBatis-Plus compatible)\n- Consistent ID generation across sessions\n- Simple API integration\n- Support for generating multiple IDs at once\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-cfbf7777049b8d656cecfae5f940a531"}