{"_id":"cellarion-mcp","_rev":"2-bc1c1bed72113985d7e7a9819182daad","name":"cellarion-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"cellarion-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","wine","cellar","cellarion","claude"],"license":"AGPL-3.0","_id":"cellarion-mcp@0.1.0","maintainers":[{"name":"cellarion","email":"info@cellarion.app"}],"homepage":"https://cellarion.app","bugs":{"url":"https://github.com/jagduvi1/Cellarion/issues"},"bin":{"cellarion-mcp":"index.js"},"dist":{"shasum":"dcb10b5a58b52c71c8ad8b9d144885e61cdb84c6","tarball":"https://registry.npmjs.org/cellarion-mcp/-/cellarion-mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-0oiQROTwAXsBBRmUbD2BtEVr/JWMmYwmx9V1Y6qB0GxMMCdY8m6kh1Jwai7Uqnybs12Vxy+oP5UcN14fNZeYXg==","signatures":[{"sig":"MEQCIE2Ep2dckmW0ICz0urPch6VNwfA61dtjUJtec4sBMmvGAiBw7ZNYC3MzHDhNMuXtwh/psaUrPRGzsUjIvoav63cwHg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43963},"type":"module","engines":{"node":">=20"},"gitHead":"51ba3be5ef5572a6e0abd53d6a54a0c8568917fe","_npmUser":{"name":"cellarion","email":"info@cellarion.app"},"repository":{"url":"git+https://github.com/jagduvi1/Cellarion.git","type":"git","directory":"cellarion-mcp"},"_npmVersion":"11.6.2","description":"Connect your AI (Claude Desktop, Cursor, …) to your Cellarion wine cellar — a stdio MCP bridge to a Cellarion server.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cellarion-mcp_0.1.0_1784364706076_0.5447630730762587","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"cellarion-mcp","version":"0.1.1","description":"Connect your AI (Claude Desktop, Cursor, …) to your Cellarion wine cellar — a stdio MCP bridge to a Cellarion server.","mcpName":"app.cellarion/cellarion","type":"module","bin":{"cellarion-mcp":"index.js"},"engines":{"node":">=20"},"keywords":["mcp","model-context-protocol","wine","cellar","cellarion","claude"],"license":"AGPL-3.0","repository":{"type":"git","url":"git+https://github.com/jagduvi1/Cellarion.git","directory":"cellarion-mcp"},"homepage":"https://cellarion.app","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"gitHead":"93433c9c93c27b39af76ca9a54d421b8da9545df","_id":"cellarion-mcp@0.1.1","bugs":{"url":"https://github.com/jagduvi1/Cellarion/issues"},"_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-rbcnnMT2IPLGY1KC1WieB+n0XL9pyT9Mu+dt+W9+WY+bDSynvfjKgdQw0mzZWqwL8d4NygXl0tzu6fUsDgIbMA==","shasum":"814b7aa7260e0822bff87e40ea62a0f450e29431","tarball":"https://registry.npmjs.org/cellarion-mcp/-/cellarion-mcp-0.1.1.tgz","fileCount":4,"unpackedSize":44004,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDoRK0YARR4QnrvCvQB+uGQbQap+x7gRyEyfvNtf0rETgIgN11sMgqOdxBb1EB+jiXk3z73sf/giOnuhqF5q4shd5I="}]},"_npmUser":{"name":"cellarion","email":"info@cellarion.app"},"directories":{},"maintainers":[{"name":"cellarion","email":"info@cellarion.app"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cellarion-mcp_0.1.1_1784399344184_0.44781628749110114"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-18T08:51:46.012Z","modified":"2026-07-18T18:29:04.453Z","0.1.0":"2026-07-18T08:51:46.207Z","0.1.1":"2026-07-18T18:29:04.307Z"},"bugs":{"url":"https://github.com/jagduvi1/Cellarion/issues"},"license":"AGPL-3.0","homepage":"https://cellarion.app","keywords":["mcp","model-context-protocol","wine","cellar","cellarion","claude"],"repository":{"type":"git","url":"git+https://github.com/jagduvi1/Cellarion.git","directory":"cellarion-mcp"},"description":"Connect your AI (Claude Desktop, Cursor, …) to your Cellarion wine cellar — a stdio MCP bridge to a Cellarion server.","maintainers":[{"name":"cellarion","email":"info@cellarion.app"}],"readme":"# cellarion-mcp\r\n\r\nConnect your AI to your wine cellar. This is the [MCP](https://modelcontextprotocol.io) bridge for [Cellarion](https://cellarion.app) — it lets stdio-based MCP clients (Claude Desktop, Cursor, …) talk to your Cellarion account, so you can ask your assistant things like:\r\n\r\n- *\"What should I open tonight before it goes past its peak?\"*\r\n- *\"Do I still have any Barolo, and where is it stored?\"*\r\n- *\"What did I drink last month, and what did I rate it?\"*\r\n\r\nIt runs entirely on **your** machine and proxies to your Cellarion server's `/api/mcp` endpoint using a personal, revocable API token. Tools and resources are defined by the server — updating Cellarion automatically updates what your AI can do; this bridge never needs to know.\r\n\r\n## Setup\r\n\r\n1. **Mint a token** in Cellarion: *Settings → API tokens* → create a token with the `read` scope. Copy the `cel_…` value (shown once).\r\n2. **Add the server to your client.** Claude Desktop (`claude_desktop_config.json`):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"cellarion\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"cellarion-mcp\"],\r\n      \"env\": {\r\n        \"CELLARION_TOKEN\": \"cel_your_token_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n3. Restart the client. Ask it about your cellar.\r\n\r\n**Self-hosting Cellarion?** Point the bridge at your instance:\r\n\r\n```json\r\n      \"env\": {\r\n        \"CELLARION_TOKEN\": \"cel_your_token_here\",\r\n        \"CELLARION_URL\": \"https://cellarion.your-domain.example\"\r\n      }\r\n```\r\n\r\n(`--token` / `--url` command-line arguments work too.)\r\n\r\n## Security notes\r\n\r\n- The token is scoped and **revocable instantly** from Cellarion — revoking it cuts this bridge off mid-session.\r\n- A `read`-scope token can only read your own cellar data. It cannot modify anything, cannot read other accounts, and cannot manage tokens.\r\n- The token goes only to the host in `CELLARION_URL` — nowhere else. Nothing is logged.\r\n\r\n## License\r\n\r\nAGPL-3.0, like Cellarion itself. Source: <https://github.com/jagduvi1/Cellarion> (`cellarion-mcp/`).\r\n","readmeFilename":"README.md"}