{"_id":"@bodangren/components-mcp","_rev":"4-3326b346343accc9d8494508d3da7ccd","name":"@bodangren/components-mcp","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@bodangren/components-mcp","version":"1.0.0","keywords":[],"author":"","license":"ISC","_id":"@bodangren/components-mcp@1.0.0","maintainers":[{"name":"bodangren","email":"bodangren@gmail.com"}],"homepage":"https://github.com/bodangren/components-mcp#readme","bugs":{"url":"https://github.com/bodangren/components-mcp/issues"},"dist":{"shasum":"60414606feb7d9ad537bdb1a99a8d75b5c4fd69c","tarball":"https://registry.npmjs.org/@bodangren/components-mcp/-/components-mcp-1.0.0.tgz","fileCount":15,"integrity":"sha512-/MeoeOGb6kBPOJIPMu7Wdv+yKFzc7VVq8rgVx7JKt0xu1FS+4J38Vl2d61DuxRrxgCL99tSRwghS3F0voEsIXg==","signatures":[{"sig":"MEQCIGdseX3usqYCoaOTjUtiKxahkxQ4YirXzUNIM133OcgJAiB9OoKz8Kw9RMVvEqic1Pffd7oHGWo2w3K6TEcOf2bCaw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72701},"main":"dist/index.js","type":"commonjs","types":"dist/index.d.ts","gitHead":"db6e99ba50c388043bd84282c3c19bb8e918e32f","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"bodangren","email":"bodangren@gmail.com"},"repository":{"url":"git+https://github.com/bodangren/components-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"A collection of reusable components and utilities.","directories":{},"_nodeVersion":"24.4.0","dependencies":{"cors":"^2.8.5","uuid":"^11.1.0","express":"^5.1.0","swagger-jsdoc":"^6.2.8","swagger-ui-express":"^5.0.1","@types/swagger-jsdoc":"^6.0.4","@types/swagger-ui-express":"^4.1.8"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/cors":"^2.8.19","@types/node":"^24.1.0","@types/uuid":"^10.0.0","@types/express":"^5.0.3"},"_npmOperationalInternal":{"tmp":"tmp/components-mcp_1.0.0_1753862119495_0.3701196725629279","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@bodangren/components-mcp","version":"1.0.2","keywords":[],"author":"","license":"ISC","_id":"@bodangren/components-mcp@1.0.2","maintainers":[{"name":"bodangren","email":"bodangren@gmail.com"}],"homepage":"https://github.com/bodangren/components-mcp#readme","bugs":{"url":"https://github.com/bodangren/components-mcp/issues"},"bin":{"components-mcp":"bin/start-server.js"},"dist":{"shasum":"35b8f24c2f67ec8b0ad3155d0f9d4f3bbab7ce9a","tarball":"https://registry.npmjs.org/@bodangren/components-mcp/-/components-mcp-1.0.2.tgz","fileCount":16,"integrity":"sha512-617kFCuweDhH6o89BZyCa0hOXAtNIfrMjFW+aBG1mzJqtKBM1Zdvb0z5ReCvzsDCi+wBYQIG/cfW2BCVrYT5UQ==","signatures":[{"sig":"MEUCIBxhrJZMpCOnOYw3spS5XrP595Rot+zCRdlL6CfsZYj3AiEA2Ol9hg8Lw9+L5poyEJ+tgx8Z77nQAOn8vqBy3oHaw3w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72710},"main":"dist/index.js","type":"commonjs","types":"dist/index.d.ts","gitHead":"1f7e98b2b3002bb99d3193138c8f284798635a0b","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"bodangren","email":"bodangren@gmail.com"},"repository":{"url":"git+https://github.com/bodangren/components-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"A collection of reusable components and utilities.","directories":{},"_nodeVersion":"24.4.0","dependencies":{"cors":"^2.8.5","uuid":"^11.1.0","express":"^5.1.0","swagger-jsdoc":"^6.2.8","swagger-ui-express":"^5.0.1","@types/swagger-jsdoc":"^6.0.4","@types/swagger-ui-express":"^4.1.8"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/cors":"^2.8.19","@types/node":"^24.1.0","@types/uuid":"^10.0.0","@types/express":"^5.0.3"},"_npmOperationalInternal":{"tmp":"tmp/components-mcp_1.0.2_1753862718301_0.3918108054610292","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@bodangren/components-mcp","version":"1.0.3","keywords":[],"author":"","license":"ISC","_id":"@bodangren/components-mcp@1.0.3","maintainers":[{"name":"bodangren","email":"bodangren@gmail.com"}],"homepage":"https://github.com/bodangren/components-mcp#readme","bugs":{"url":"https://github.com/bodangren/components-mcp/issues"},"bin":{"components-mcp":"bin/start-server.js"},"dist":{"shasum":"88beba32f9f5e39ee8a355e24a82647587604e1b","tarball":"https://registry.npmjs.org/@bodangren/components-mcp/-/components-mcp-1.0.3.tgz","fileCount":16,"integrity":"sha512-A1F5ZyyrQ7j9eHcllK6KCHJxPqeApuGcb69DCXtHETejFSawCvB1NzgB8gFXGfEktdkM+/DAG5x+k5EbYgOAJw==","signatures":[{"sig":"MEQCIHdAPjRoadfcgj8mv9ugZAYOLmchD5QlFgd/JGY7fe8GAiAggytkIXjxKggKxehl2Zxd0vTufwm8u1tp47kjlaCm1w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72710},"main":"dist/index.js","type":"commonjs","types":"dist/index.d.ts","gitHead":"f499dedf44ad166bcca9aea0db0c61395d12057e","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"bodangren","email":"bodangren@gmail.com"},"repository":{"url":"git+https://github.com/bodangren/components-mcp.git","type":"git"},"_npmVersion":"11.4.2","description":"A collection of reusable components and utilities.","directories":{},"_nodeVersion":"24.4.0","dependencies":{"cors":"^2.8.5","uuid":"^11.1.0","express":"^5.1.0","swagger-jsdoc":"^6.2.8","swagger-ui-express":"^5.0.1","@types/swagger-jsdoc":"^6.0.4","@types/swagger-ui-express":"^4.1.8"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/cors":"^2.8.19","@types/node":"^24.1.0","@types/uuid":"^10.0.0","@types/express":"^5.0.3"},"_npmOperationalInternal":{"tmp":"tmp/components-mcp_1.0.3_1753863882006_0.5535430977812614","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@bodangren/components-mcp","version":"1.0.4","description":"A collection of reusable components and utilities.","main":"dist/index.js","types":"dist/index.d.ts","repository":{"type":"git","url":"git+https://github.com/bodangren/components-mcp.git"},"keywords":[],"bin":{"components-mcp":"bin/start-server.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"ts-node src/index.ts"},"author":"","license":"ISC","type":"commonjs","dependencies":{"@types/swagger-jsdoc":"^6.0.4","@types/swagger-ui-express":"^4.1.8","cors":"^2.8.5","express":"^5.1.0","swagger-jsdoc":"^6.2.8","swagger-ui-express":"^5.0.1","uuid":"^11.1.0"},"devDependencies":{"@types/cors":"^2.8.19","@types/express":"^5.0.3","@types/node":"^24.1.0","@types/uuid":"^10.0.0","ts-node":"^10.9.2","typescript":"^5.8.3"},"_id":"@bodangren/components-mcp@1.0.4","gitHead":"17a29931e43f33c00bcfb5ca6d123fcd5c22e905","bugs":{"url":"https://github.com/bodangren/components-mcp/issues"},"homepage":"https://github.com/bodangren/components-mcp#readme","_nodeVersion":"24.4.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-eiJv0hcppWRwP8ep9dzHEmc2MJ+ke5h7m3opB0/T2lRYy8fgSmTYUm/kpfh/MlGXXbbrs+RMUOIiRK7TWDo5UA==","shasum":"0c136ec42a83d1589ead84fd11294fedc54faa43","tarball":"https://registry.npmjs.org/@bodangren/components-mcp/-/components-mcp-1.0.4.tgz","fileCount":16,"unpackedSize":73359,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD0D+3ANb9Pg+mFlS65TorYg+7jqESSCwUL8z12I4EDBwIhALbmmly1G3LBwPuXDn49JQDnYZFChrphVOacXiYyztPz"}]},"_npmUser":{"name":"bodangren","email":"bodangren@gmail.com"},"directories":{},"maintainers":[{"name":"bodangren","email":"bodangren@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/components-mcp_1.0.4_1753864503547_0.3096108874747223"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-30T07:55:19.396Z","modified":"2025-07-30T08:35:03.943Z","1.0.0":"2025-07-30T07:55:19.758Z","1.0.2":"2025-07-30T08:05:18.496Z","1.0.3":"2025-07-30T08:24:42.189Z","1.0.4":"2025-07-30T08:35:03.709Z"},"bugs":{"url":"https://github.com/bodangren/components-mcp/issues"},"license":"ISC","homepage":"https://github.com/bodangren/components-mcp#readme","keywords":[],"repository":{"type":"git","url":"git+https://github.com/bodangren/components-mcp.git"},"description":"A collection of reusable components and utilities.","maintainers":[{"name":"bodangren","email":"bodangren@gmail.com"}],"readme":"# Knowledge-Base Server for the \"[Your Project Name]\" Next.js Project\n\nThis project is a dedicated knowledge-base server. Its primary purpose is to provide a persistent, queryable memory for an LLM agent (e.g., Gemini) that assists with the development of our main Next.js project. It stores canonical information about the project's components and APIs, allowing the LLM to access up-to-date details without having to parse the entire codebase repeatedly. This includes details about available components, sample code snippets, and API specifications.\n\n## Features\n\n- **Code Conventions API**: Manage information about code conventions.\n  - `GET /conventions`: Get all code conventions.\n  - `POST /conventions`: Add a new code convention.\n  - `PUT /conventions/{id}`: Update a code convention by ID.\n  - `DELETE /conventions/{id}`: Delete a code convention by ID.\n- **Custom Hooks API**: Manage information about custom hooks.\n  - `GET /hooks`: Get all custom hooks.\n  - `POST /hooks`: Add a new custom hook.\n  - `PUT /hooks/{id}`: Update a custom hook by ID.\n  - `DELETE /hooks/{id}`: Delete a custom hook by ID.\n- **Environment Variables API**: Manage information about environment variables.\n  - `GET /environment`: Get all environment variables.\n  - `POST /environment`: Add a new environment variable.\n  - `PUT /environment/{id}`: Update an environment variable by ID.\n  - `DELETE /environment/{id}`: Delete an environment variable by ID.\n- **State Management API**: Manage information about state management configurations.\n  - `GET /state`: Get all state management configurations.\n  - `POST /state`: Add a new state management configuration.\n  - `PUT /state/{id}`: Update a state management configuration by ID.\n  - `DELETE /state/{id}`: Delete a state management configuration by ID.\n- **Styling API**: Manage information about styling configurations.\n  - `GET /styling`: Get all styling configurations.\n  - `POST /styling`: Add a new styling configuration.\n  - `PUT /styling/{id}`: Update a styling configuration by ID.\n  - `DELETE /styling/{id}`: Delete a styling configuration by ID.\n- **APIs API**: Manage information about available APIs.\n  - `GET /apis`: Retrieve a list of APIs.\n  - `POST /apis`: Create a new API.\n  - `GET /apis/{id}`: Retrieve a single API by ID.\n  - `PUT /apis/{id}`: Update an API by ID.\n  - `DELETE /apis/{id}`: Delete an API.\n- **Components API**: Manage information about reusable Next.js components.\n  - `GET /components`: Retrieve a list of components.\n  - `POST /components`: Create a new component.\n  - `GET /components/{id}`: Retrieve a single component by ID.\n  - `PUT /components/{id}`: Update a component by ID.\n  - `DELETE /components/{id}`: Delete a component.\n\n## Schemas\n\n- `IEnvironmentVar`\n- `IStyling`\n- `IStateManagement`\n- `ICustomHook`\n- `ICodeConvention`\n- `API`\n- `APIInput`\n- `Component`\n- `ComponentSummary`\n- `ComponentInput`\n\n- **Root Endpoint Documentation**: A `/` endpoint provides an overview of all available API endpoints.\n\n## Project Structure\n\n```\n/\n├── data/\n│   └── db.json\n├── dist/ (compiled JavaScript output)\n├── src/\n│   ├── index.ts (main server file)\n│   ├── routes/\n│   │   ├── components.ts (component API routes)\n│   │   └── apis.ts (API API routes)\n│   └── types/\n│       └── index.ts (TypeScript interfaces)\n├── package.json\n├── tsconfig.json\n├── README.md\n├── GEMINI.md\n└── .gitignore\n```\n\n## Setup and Installation\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/bodangren/components-mcp.git\n    cd components-mcp\n    ```\n\n2.  **Install dependencies:**\n    ```bash\n    npm install\n    ```\n\n3.  **Build the project:**\n    ```bash\n    npm run build\n    ```\n\n## Running the Server\n\nTo run the server in development mode (with `ts-node`):\n\n```bash\nnpm run dev\n```\n\nTo run the compiled server:\n\n```bash\nnpm run start\n```\n\nThe server will run on `http://localhost:3001`.\n\n## Data Storage\n\nAPI data is stored in `data/db.json`. This is a simple JSON file for easy local management. For production environments, consider migrating to a more robust database solution.\n\n## Purpose and AI-Assisted Workflow\n\nThis server is not intended for direct human interaction in a production environment. Instead, it runs locally during development and serves as the single source of truth for our project's key architectural pieces.\n\nThe intended workflow is:\n1.  The developer interacts with an LLM agent to ask questions or issue commands related to the main Next.js project.\n2.  The LLM agent queries this server's API (`/apis`, `/components`) to retrieve accurate, structured information.\n3.  When a developer asks the LLM to create or modify a component or API, the LLM will use this server's `POST` or `PUT` endpoints to update the knowledge base accordingly.\n","readmeFilename":"README.md"}