{"_id":"@appcolab/mcp-server","name":"@appcolab/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@appcolab/mcp-server","version":"1.0.0","description":"Model Context Protocol server for AppColab - Access your PRD documents directly in your IDE","main":"dist/index.js","bin":{"appcolab-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","watch":"tsx watch src/index.ts","prepare":"npm run build"},"keywords":["mcp","model-context-protocol","appcolab","prd","ide-integration","claude"],"author":{"name":"AppColab Team"},"license":"MIT","private":false,"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","commander":"^11.1.0","dotenv":"^16.3.0"},"devDependencies":{"@types/node":"^20.10.0","tsx":"^4.6.0","typescript":"^5.3.0"},"repository":{"type":"git","url":"git+https://github.com/appcolab/appcolab.git"},"bugs":{"url":"https://github.com/appcolab/appcolab/issues"},"homepage":"https://appcolab.dev","_id":"@appcolab/mcp-server@1.0.0","gitHead":"e2c9fbd80ba763efe1e50bca486a01051b483ba7","types":"./dist/index.d.ts","_nodeVersion":"20.19.4","_npmVersion":"11.5.2","dist":{"integrity":"sha512-hfA2EO35It5sxUrbBlXFJzPT8kMRbRn8p0F1qedafZJyUkLYELWeqga4fOxjFBXmpWtR4cqEM1stkaNIMZba0w==","shasum":"3a2771f186850385ccae57544faad8051996a22b","tarball":"https://registry.npmjs.org/@appcolab/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":18,"unpackedSize":65305,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDuvF5lkIhyhMf8j7gYb/O9Benjhfy8hMB0tAKvSq/0qwIhAM4KTARG1jJrEsFzGV/n9VrfPVrSY8iALEXiyXOQuSwQ"}]},"_npmUser":{"name":"adpreethamkumar96","email":"adpreethamkumar96@gmail.com"},"directories":{},"maintainers":[{"name":"adpreethamkumar96","email":"adpreethamkumar96@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.0_1757405685186_0.3981601746485739"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-09T08:14:45.066Z","1.0.0":"2025-09-09T08:14:45.387Z","modified":"2025-09-09T08:14:45.633Z"},"maintainers":[{"name":"adpreethamkumar96","email":"adpreethamkumar96@gmail.com"}],"description":"Model Context Protocol server for AppColab - Access your PRD documents directly in your IDE","homepage":"https://appcolab.dev","keywords":["mcp","model-context-protocol","appcolab","prd","ide-integration","claude"],"repository":{"type":"git","url":"git+https://github.com/appcolab/appcolab.git"},"author":{"name":"AppColab Team"},"bugs":{"url":"https://github.com/appcolab/appcolab/issues"},"license":"MIT","readme":"# AppColab MCP Server\n\n> **Access your AppColab PRD documents directly in your IDE**\n\nThe AppColab MCP Server provides Model Context Protocol (MCP) integration, allowing you to access your product specifications, user stories, technical architecture, and AI coding prompts directly from IDEs that support MCP, such as Claude Desktop and Cursor.\n\n## 🚀 Quick Start\n\n### 1. Installation\n\n```bash\nnpm install -g @appcolab/mcp-server\n```\n\n### 2. Get Your API Key\n\n1. Visit [AppColab Settings](https://appcolab.dev/settings/api-keys)\n2. Create a new API key for MCP access\n3. Copy the generated key\n\n### 3. Configure Claude Desktop\n\nAdd the following to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"appcolab\": {\n      \"command\": \"npx\",\n      \"args\": [\"@appcolab/mcp-server\", \"start\"],\n      \"env\": {\n        \"APPCOLAB_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 4. Restart Claude Desktop\n\nRestart Claude Desktop to load the MCP server.\n\n## 🛠️ Available Tools\n\nOnce configured, you'll have access to these tools in Claude Desktop:\n\n### `appcolab_list_projects`\nLists all your AppColab projects with basic information.\n\n**Usage:**\n```\nPlease list my AppColab projects\n```\n\n### `appcolab_get_prd`\nRetrieves the complete PRD document for a specific project.\n\n**Parameters:**\n- `projectId` (required): The ID of the project\n- `version` (optional): Specific version number (defaults to latest)\n\n**Usage:**\n```\nGet the PRD for project abc123\n```\n\n### `appcolab_get_user_stories`\nExtracts Phase 2 user stories and feature specifications.\n\n**Parameters:**\n- `projectId` (required): The ID of the project\n\n**Usage:**\n```\nShow me the user stories for project abc123\n```\n\n### `appcolab_get_technical_specs`\nRetrieves Phase 2 technical architecture and specifications.\n\n**Parameters:**\n- `projectId` (required): The ID of the project\n\n**Usage:**\n```\nGet technical specifications for project abc123\n```\n\n### `appcolab_get_implementation_guide`\nGets Phase 3 implementation guide and development specifications.\n\n**Parameters:**\n- `projectId` (required): The ID of the project\n\n**Usage:**\n```\nShow implementation guide for project abc123\n```\n\n### `appcolab_get_ai_prompts`\nRetrieves AI coding tool prompts (Cursor, V0, Bolt) for implementation.\n\n**Parameters:**\n- `projectId` (required): The ID of the project\n- `tool` (optional): Specific tool (`cursor`, `v0`, `bolt`, or `all`)\n\n**Usage:**\n```\nGet Cursor prompts for project abc123\n```\n\n## 📖 Example Workflow\n\nHere's a typical workflow using the MCP server:\n\n1. **List Projects:**\n   ```\n   Please list my AppColab projects\n   ```\n\n2. **Get Project Details:**\n   ```\n   Get the complete PRD for project [project-id]\n   ```\n\n3. **Extract Specific Information:**\n   ```\n   Show me the user stories for this project\n   Get the technical specifications \n   What are the AI prompts for Cursor?\n   ```\n\n4. **Use in Development:**\n   ```\n   Based on the implementation guide, help me set up the development environment\n   ```\n\n## 🔧 Configuration Options\n\n### Environment Variables\n\n- `APPCOLAB_API_KEY`: Your AppColab API key (required)\n- `APPCOLAB_BASE_URL`: Custom AppColab instance URL (optional, defaults to https://appcolab.dev)\n\n### Command Line Options\n\n```bash\n# Start with API key\nappcolab-mcp start --api-key your_key_here\n\n# Initialize configuration helper\nappcolab-mcp init\n```\n\n## 🏗️ Development Setup\n\n### Prerequisites\n\n- Node.js 18+ \n- TypeScript 5+\n- Access to an AppColab account with PRD documents\n\n### Local Development\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/appcolab/appcolab\n   cd appcolab/mcp-server\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment:**\n   ```bash\n   cp .env.example .env\n   # Edit .env with your API key\n   ```\n\n4. **Development server:**\n   ```bash\n   npm run dev\n   ```\n\n5. **Build for production:**\n   ```bash\n   npm run build\n   ```\n\n## 🔒 Security\n\n### API Key Management\n\n- API keys are hashed and stored securely in the AppColab database\n- Keys can be revoked instantly from the AppColab dashboard\n- Each API key tracks usage and last access time\n- Keys support optional expiration dates\n\n### Authentication Flow\n\n1. MCP server receives request with Bearer token\n2. Token is hashed and validated against AppColab database\n3. User permissions are verified\n4. Request is processed and response returned\n\n### Best Practices\n\n- **Rotate keys regularly**: Generate new API keys periodically\n- **Use environment variables**: Never hard-code API keys in configuration files\n- **Monitor usage**: Check API key usage in AppColab dashboard\n- **Revoke unused keys**: Remove API keys that are no longer needed\n\n## 🚨 Troubleshooting\n\n### Common Issues\n\n**\"Invalid or expired API key\"**\n- Verify your API key is correct\n- Check if the key has expired\n- Ensure the key is active in AppColab settings\n\n**\"Cannot connect to AppColab server\"**\n- Check your internet connection\n- Verify the APPCOLAB_BASE_URL if using a custom instance\n- Ensure AppColab servers are accessible\n\n**\"Project not found\"**\n- Verify you have access to the project\n- Check that the project ID is correct\n- Ensure the project status is active\n\n**Claude Desktop doesn't show AppColab tools**\n- Restart Claude Desktop after configuration changes\n- Check the configuration file syntax\n- Verify the MCP server is running (check Claude Desktop logs)\n\n### Debug Mode\n\nEnable verbose logging:\n\n```json\n{\n  \"mcpServers\": {\n    \"appcolab\": {\n      \"command\": \"npx\",\n      \"args\": [\"@appcolab/mcp-server\", \"start\"],\n      \"env\": {\n        \"APPCOLAB_API_KEY\": \"your_key\",\n        \"DEBUG\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Getting Help\n\n- **Documentation**: Visit [AppColab Docs](https://docs.appcolab.dev)\n- **Support**: Email support@appcolab.dev\n- **GitHub Issues**: [Report bugs](https://github.com/appcolab/appcolab/issues)\n- **Community**: Join our Discord server\n\n## 🔄 API Endpoints\n\nThe MCP server communicates with these AppColab API endpoints:\n\n- `GET /api/mcp/auth` - Validate API key\n- `GET /api/mcp/projects` - List user projects\n- `GET /api/mcp/projects/:id/prd` - Get complete PRD\n- `GET /api/mcp/projects/:id/user-stories` - Get user stories\n- `GET /api/mcp/projects/:id/technical-specs` - Get technical specs\n- `GET /api/mcp/projects/:id/implementation-guide` - Get implementation guide\n- `GET /api/mcp/projects/:id/ai-prompts` - Get AI coding prompts\n\n## 📋 Requirements\n\n### System Requirements\n\n- **Node.js**: 18.0.0 or higher\n- **Memory**: 128MB minimum\n- **Network**: HTTPS access to appcolab.dev\n\n### AppColab Account Requirements\n\n- Active AppColab account\n- At least one project with generated PRD\n- API key with appropriate permissions\n\n### Supported IDEs\n\n- **Claude Desktop** (Primary support)\n- **Cursor** (Via MCP integration)\n- **VS Code** (With MCP extensions)\n- Any IDE supporting Model Context Protocol\n\n## 🚀 What's Next?\n\n### Planned Features\n\n- **Real-time updates**: Auto-refresh PRDs when updated in AppColab\n- **Offline caching**: Local storage of frequently accessed PRDs\n- **Team collaboration**: Shared API keys for team access\n- **Custom templates**: Export PRDs in custom formats\n- **IDE-specific features**: Enhanced integration with popular IDEs\n\n### Contributing\n\nWe welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) for details on:\n\n- Code of conduct\n- Development workflow  \n- Pull request process\n- Issue reporting\n\n## 📄 License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n---\n\n**Made with ❤️ by the AppColab team**\n\nTransform your product ideas into production-ready specifications, then implement them seamlessly with AI coding tools.\n\n[Website](https://appcolab.dev) • [Documentation](https://docs.appcolab.dev) • [GitHub](https://github.com/appcolab/appcolab) • [Discord](https://discord.gg/appcolab)","readmeFilename":"README.md","_rev":"1-3d07fc8b0a7c36980fa856378b31cd29"}