{"_id":"@cyberdeck-club/mcp-server","_rev":"3-ffc19ea0cb3ddbd4b7c69ad83db05dd6","name":"@cyberdeck-club/mcp-server","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@cyberdeck-club/mcp-server","version":"0.1.0","keywords":["mcp","cyberdeck","ai"],"author":{"name":"cyberdeck.club"},"license":"MIT","_id":"@cyberdeck-club/mcp-server@0.1.0","maintainers":[{"name":"therebelrobot","email":"npm@therebelrobot.com"}],"bin":{"cyberdeck-mcp":"dist/index.js"},"dist":{"shasum":"b5fed6811fd4cc3bdf5edee8871224230737f566","tarball":"https://registry.npmjs.org/@cyberdeck-club/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":14,"integrity":"sha512-Omfx0AStEYLxp7TioLMBx846I+4As8gANZQhSLj0o5pmAS3o8Bu3BDRy6gWGgIxkbKDM970IKPEYU0i8tNDZaw==","signatures":[{"sig":"MEUCIAMHp/NgVyrbZJ52KLCqfjarVqf4lYZ+uTyX92xXiZIDAiEAyaVGzvxCCxwTdToo+27SUYGb9orywp3ZBUl/TjcdUnU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94480},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"de6eee21861b526d04b98c685800cd9a3e79a5f5","scripts":{"dev":"tsup src/index.ts --format esm --watch","build":"tsup src/index.ts --format esm --dts --clean","start":"node dist/index.js"},"_npmUser":{"name":"therebelrobot","email":"npm@therebelrobot.com"},"_npmVersion":"11.11.0","description":"MCP server for cyberdeck.club — manage builds, wiki, forum, meetups via AI assistants","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1777851958826_0.2775528995656129","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cyberdeck-club/mcp-server","version":"0.1.1","keywords":["mcp","cyberdeck","ai"],"author":{"name":"cyberdeck.club"},"license":"MIT","_id":"@cyberdeck-club/mcp-server@0.1.1","maintainers":[{"name":"therebelrobot","email":"npm@therebelrobot.com"}],"bin":{"cyberdeck-mcp":"dist/index.js"},"dist":{"shasum":"73e622b175149e3a1ba05192885cd4a16de6fd09","tarball":"https://registry.npmjs.org/@cyberdeck-club/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":14,"integrity":"sha512-5Qb0DTTkRz0GIoGajWYwl+hrI+fpgXJ0O2qZAyHnZUsmrfJ5HfEszVUNxIUnz2DXzKeAaT85ETkqci1wpX5GsQ==","signatures":[{"sig":"MEYCIQCZyHweSjFPIsNnhpI6okLJd1fVPeuGUVgSrcfgZhDTJAIhAPjjEF8APZ0R6Zw0ktXNIwMDWAIryln1vpH2YDjRbnvY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94516},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"de6eee21861b526d04b98c685800cd9a3e79a5f5","scripts":{"dev":"tsup src/index.ts --format esm --watch","build":"tsup src/index.ts --format esm --dts --clean","start":"node dist/index.js","postinstall":"npm run build"},"_npmUser":{"name":"therebelrobot","email":"npm@therebelrobot.com"},"_npmVersion":"11.11.0","description":"MCP server for cyberdeck.club — manage builds, wiki, forum, meetups via AI assistants","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.0.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1777852478764_0.27838659338155813","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyberdeck-club/mcp-server","version":"0.1.2","description":"MCP server for cyberdeck.club — manage builds, wiki, forum, meetups via AI assistants","type":"module","main":"dist/index.js","bin":{"cyberdeck-mcp":"dist/index.js"},"scripts":{"build":"tsup src/index.ts --format esm --dts --clean","dev":"tsup src/index.ts --format esm --watch","start":"node dist/index.js","postinstall":"npm run build"},"keywords":["mcp","cyberdeck","ai"],"author":{"name":"cyberdeck.club"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^22.0.0","tsup":"^8.0.0","typescript":"^5.0.0"},"gitHead":"de6eee21861b526d04b98c685800cd9a3e79a5f5","types":"./dist/index.d.ts","_id":"@cyberdeck-club/mcp-server@0.1.2","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-NASCZsSevuCp6ZStW8Kt+BZu0WUgAc764m46i6fd4F26nzc6ckaj0hdJXOoYZY3cIQSgSs955udcnsyxJwWoLw==","shasum":"ee7f9faa8b1a2947acd6d12fb9fffffda5b67a7d","tarball":"https://registry.npmjs.org/@cyberdeck-club/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":14,"unpackedSize":94566,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGJvyuEWIXy6BwahHgIBls7I5Du6zXnFfveiudjlr52iAiBwVcMmaIe/HOJvz8VlcMRyvVkU4iqQyQiHy8kBLqKACQ=="}]},"_npmUser":{"name":"therebelrobot","email":"npm@therebelrobot.com"},"directories":{},"maintainers":[{"name":"therebelrobot","email":"npm@therebelrobot.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.2_1777852771376_0.9522836285101315"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-03T23:45:58.690Z","modified":"2026-05-03T23:59:31.631Z","0.1.0":"2026-05-03T23:45:58.964Z","0.1.1":"2026-05-03T23:54:38.892Z","0.1.2":"2026-05-03T23:59:31.526Z"},"author":{"name":"cyberdeck.club"},"license":"MIT","keywords":["mcp","cyberdeck","ai"],"description":"MCP server for cyberdeck.club — manage builds, wiki, forum, meetups via AI assistants","maintainers":[{"name":"therebelrobot","email":"npm@therebelrobot.com"}],"readme":"# cyberdeck-mcp-server\n\nMCP (Model Context Protocol) server for [cyberdeck.club](https://cyberdeck.club) — enables AI assistants to interact with the cyberdeck.club API using Personal Access Tokens (PATs).\n\n## Overview\n\nThis package provides an MCP server that exposes tools for managing:\n\n- **Builds** — List, view, create, and update cyberdeck build showcases\n- **Wiki** — Browse and edit wiki articles with revision history\n- **Forum** — Participate in community discussions\n- **Meetups** — Discover and create community events\n- **Profile** — Manage your user profile\n- **Admin** — Administrative operations (token management, user roles)\n\n## Installation\n\n```bash\nnpm install @cyberdeck-club/mcp-server\n```\n\n## Configuration\n\nThe server requires a Personal Access Token (PAT) from cyberdeck.club.\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CYBERDECK_PAT` | Yes | — | Personal Access Token from cyberdeck.club/settings |\n| `CYBERDECK_API_URL` | No | `https://cyberdeck.club` | Base URL of the cyberdeck.club API |\n\n### Generating a Personal Access Token\n\n1. Log in to [cyberdeck.club](https://cyberdeck.club)\n2. Go to Settings → Personal Access Tokens\n3. Create a new token with the desired scopes\n4. Copy the token and store it securely\n\n## Usage\n\n### Running as a Standalone Server\n\n```bash\n# Set your PAT\nexport CYBERDECK_PAT=\"your_personal_access_token\"\n\n# Run the server\nnpx @cyberdeck-club/mcp-server\n```\n\n### Using with Claude Desktop\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"cyberdeck\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cyberdeck-club/mcp-server\"],\n      \"env\": {\n        \"CYBERDECK_PAT\": \"your_personal_access_token\"\n      }\n    }\n  }\n}\n```\n\n### Using with Other MCP Clients\n\nThe server communicates over stdio. Configure your MCP client to spawn it as a subprocess:\n\n```bash\nCYBERDECK_PAT=your_token node ./node_modules/@cyberdeck-club/mcp-server/dist/index.js\n```\n\n## Available Tools\n\n### Build Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `list_builds` | List all published builds with pagination | `builds:read` |\n| `get_build` | Get details of a specific build | `builds:read` |\n| `create_build` | Submit a new build for publication | `builds:write` |\n| `update_build` | Update an existing build | `builds:write` |\n| `list_build_comments` | Get comments on a build | `builds:read` |\n| `add_build_comment` | Add a comment to a build | `builds:write` |\n\n### Wiki Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `list_wiki_articles` | List wiki articles with optional category filter | `wiki:read` |\n| `get_wiki_article` | Get a specific wiki article by category and slug | `wiki:read` |\n| `create_wiki_article` | Create a new wiki article | `wiki:write` |\n| `update_wiki_article` | Update an existing wiki article | `wiki:write` |\n| `get_wiki_article_history` | Get revision history for a wiki article | `wiki:read` |\n\n### Forum Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `list_forum_threads` | List forum threads with optional category filter | `forum:read` |\n| `get_forum_thread` | Get a specific forum thread with posts | `forum:read` |\n| `create_forum_thread` | Create a new forum thread | `forum:write` |\n| `list_forum_posts` | Get posts in a thread | `forum:read` |\n| `create_forum_post` | Reply to a forum thread | `forum:write` |\n\n### Meetup Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `list_meetups` | List upcoming meetup events | `meetups:read` |\n| `create_meetup` | Create a new meetup event | `meetups:write` |\n\n### Profile Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `get_my_profile` | Get your user profile | `profile:read` |\n| `update_my_profile` | Update your display name, bio, or avatar | `profile:write` |\n\n### Admin Tools\n\n| Tool | Description | Required Scope |\n|------|-------------|----------------|\n| `list_all_tokens` | List all personal access tokens (admin) | `admin:read` |\n| `list_token_logs` | View usage logs for tokens (admin) | `admin:read` |\n| `list_users` | List all users (admin) | `admin:read` |\n| `update_user_role` | Update a user's role (admin) | `admin:write` |\n\n## Token Scopes\n\nWhen creating a PAT, you can select from these scopes:\n\n| Scope | Description |\n|-------|-------------|\n| `builds:read` | Read builds and build comments |\n| `builds:write` | Create and update builds |\n| `wiki:read` | Read wiki articles and history |\n| `wiki:write` | Create and edit wiki articles |\n| `forum:read` | Read forum threads and posts |\n| `forum:write` | Create forum threads and reply |\n| `meetups:read` | Read meetup events |\n| `meetups:write` | Create meetup events |\n| `profile:read` | Read your profile |\n| `profile:write` | Update your profile |\n| `moderation:read` | View moderation queue |\n| `moderation:write` | Approve/reject content |\n| `admin:read` | Administrative read operations |\n| `admin:write` | Administrative write operations |\n| `*` | Full access to all endpoints |\n\n## Role Requirements\n\nSome tools require specific user roles:\n\n| Tool | Required Role |\n|------|---------------|\n| `create_wiki_article` | Maker or higher |\n| `update_wiki_article` | Maker or higher |\n| `create_forum_thread` | Maker or higher |\n| `create_meetup` | Trusted Maker or higher |\n| `update_user_role` | Admin only |\n| `list_all_tokens` | Admin only |\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/cyberdeck-club/cyberdeck.club.git\ncd cyberdeck.club/mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Watch mode\nnpm run dev\n```\n\n## License\n\nMIT","readmeFilename":"README.md"}