{"_id":"@ai-mapping/mcp-nextjs-dev","name":"@ai-mapping/mcp-nextjs-dev","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@ai-mapping/mcp-nextjs-dev","version":"1.0.0","description":"MCP server for managing Next.js development processes with AI tools","type":"module","main":"dist/server.js","bin":{"mcp-nextjs-dev":"dist/cli.js"},"packageManager":"pnpm@10.11.0","engines":{"node":">=22.0.0","pnpm":">=10.0.0"},"scripts":{"build":"tsc -p tsconfig.build.json","dev":"tsc -p tsconfig.build.json --watch","start":"node dist/cli.js","test":"vitest run","test:watch":"vitest","lint":"eslint src --ext .ts","lint:fix":"eslint src --ext .ts --fix","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\"","typecheck":"tsc --noEmit","clean":"rm -rf dist","precommit":"pnpm run typecheck && pnpm run lint && pnpm run format:check"},"keywords":["mcp","model-context-protocol","nextjs","next.js","development-server","dev-server","claude","claude-code","ai-assistant","dev-tools","development-tools","automation","process-management","log-monitoring","typescript","nodejs"],"author":{"name":"AI Mapping Organization"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ai-mapping/mcp-nextjs-dev.git"},"bugs":{"url":"https://github.com/ai-mapping/mcp-nextjs-dev/issues"},"homepage":"https://github.com/ai-mapping/mcp-nextjs-dev#readme","publishConfig":{"@ai-mapping:registry":"https://registry.npmjs.org"},"dependencies":{"@modelcontextprotocol/sdk":"latest","zod":"^3.22.0","commander":"^11.0.0","chalk":"^5.0.0","dotenv":"^16.0.0"},"devDependencies":{"@types/node":"^22.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","eslint-config-prettier":"^9.0.0","eslint-plugin-prettier":"^5.0.0","prettier":"^3.0.0","typescript":"^5.0.0","tsx":"^4.0.0","vitest":"^1.0.0"},"_id":"@ai-mapping/mcp-nextjs-dev@1.0.0","gitHead":"cf93b0be90cbf2c7f9151bdb9595ae0837ced5c3","types":"./dist/server.d.ts","_nodeVersion":"22.11.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-B+fqE9rpBGsmRSN+SIXKfVhSibL4m+K4kILaAlbHlFjocKhbyTcTZa+S9EUFdN+vLcuM1M7bpFZN9ryiTG1FQA==","shasum":"f110e676a1ca46ceecef0fd32c754f1e891471a6","tarball":"https://registry.npmjs.org/@ai-mapping/mcp-nextjs-dev/-/mcp-nextjs-dev-1.0.0.tgz","fileCount":32,"unpackedSize":63146,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCQvIJU8qkPwBIQd/WiDAcRWjDFGfEpUFwzHOeDX0PUkwIgSmyLlqcZxa1c7N7IsdpkuQ6v1Tn/tsTE6bFfVpOFBg4="}]},"_npmUser":{"name":"usulpro","email":"regx@usul.su"},"directories":{},"maintainers":[{"name":"usulpro","email":"regx@usul.su"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-nextjs-dev_1.0.0_1749306483858_0.45297968998789795"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-07T14:28:03.754Z","1.0.0":"2025-06-07T14:28:04.083Z","modified":"2025-06-07T14:28:04.385Z"},"maintainers":[{"name":"usulpro","email":"regx@usul.su"}],"description":"MCP server for managing Next.js development processes with AI tools","homepage":"https://github.com/ai-mapping/mcp-nextjs-dev#readme","keywords":["mcp","model-context-protocol","nextjs","next.js","development-server","dev-server","claude","claude-code","ai-assistant","dev-tools","development-tools","automation","process-management","log-monitoring","typescript","nodejs"],"repository":{"type":"git","url":"git+https://github.com/ai-mapping/mcp-nextjs-dev.git"},"author":{"name":"AI Mapping Organization"},"bugs":{"url":"https://github.com/ai-mapping/mcp-nextjs-dev/issues"},"license":"MIT","readme":"# @ai-mapping/mcp-nextjs-dev\n\n> MCP server for managing Next.js development processes with Claude Code\n\nAn official Model Context Protocol (MCP) server that enables AI assistants like Claude Code to manage Next.js development servers without blocking. Start, monitor, and debug Next.js applications seamlessly through AI-powered development workflows.\n\n## Features\n\n🚀 **Non-blocking Next.js development server management**  \n📊 **Real-time log access and filtering**  \n🛠️ **Process monitoring and control**  \n🔧 **Debug-friendly with comprehensive error handling**  \n🤖 **Optimized for AI assistant integration**\n\n## Problem Solved\n\nClaude Code hangs when running `npm run dev` because the process doesn't terminate. This MCP server provides asynchronous tools to start Next.js development servers in the background and access their logs for analysis.\n\n## Installation\n\n### Prerequisites\n- Node.js 22+ \n- Next.js project\n\n### Quick Start\n```bash\n# Install and run\nnpx @ai-mapping/mcp-nextjs-dev\n\n# Or install globally\nnpm install -g @ai-mapping/mcp-nextjs-dev\nmcp-nextjs-dev\n```\n\n### Claude Code Integration\nAdd to your Claude Desktop configuration (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"nextjs-dev\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ai-mapping/mcp-nextjs-dev\"],\n      \"cwd\": \".\"\n    }\n  }\n}\n```\n\n## Usage with Claude Code\n\n### Example Prompts\n\n**Start Development Server:**\n```\n\"Start the Next.js development server for this project\"\n```\n\n**Check for Errors:**\n```\n\"Are there any compilation errors in the Next.js logs? Show me the last 20 error messages.\"\n```\n\n**Monitor Server Status:**\n```\n\"Is the Next.js development server still running? What's the current status?\"\n```\n\n**Debug Issues:**\n```\n\"The app isn't working. Can you check the Next.js logs for any warnings or errors in the last 2 minutes?\"\n```\n\n**Clean Shutdown:**\n```\n\"Stop the Next.js development server and clean up any processes.\"\n```\n\n### Available Tools\n\n- `nextjs_dev_start` - Start Next.js development server\n- `nextjs_get_logs` - Retrieve filtered development logs  \n- `nextjs_get_status` - Check server status and uptime\n- `nextjs_stop_server` - Stop development server gracefully\n\n## Configuration\n\n### Command Line Options\n```bash\nnpx @ai-mapping/mcp-nextjs-dev --help\nnpx @ai-mapping/mcp-nextjs-dev --debug\n```\n\n### Environment Variables\n```bash\n# Enable debug logging\nDEBUG=1 npx @ai-mapping/mcp-nextjs-dev\n```\n\n## Development\n\nThis project uses:\n- TypeScript with ES modules\n- Node.js 22+ features\n- Official MCP SDK\n- pnpm package manager\n\n### Building from Source\n```bash\n# Clone the repository\ngit clone https://github.com/ai-mapping/mcp-nextjs-dev.git\ncd mcp-nextjs-dev\n\n# Install dependencies\npnpm install\n\n# Build the project\npnpm run build\n\n# Run tests\npnpm test\n```\n\n### Project Structure\n```\n@ai-mapping/mcp-nextjs-dev/\n├── src/\n│   ├── server.ts          # Main MCP server\n│   ├── cli.ts            # CLI entry point\n│   ├── managers/         # Process and state management\n│   └── types/            # TypeScript definitions\n├── dist/                 # Compiled JavaScript\n└── bin/                  # Executable scripts\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**Port Already in Use:**\n```bash\n# Check what's using the port\nlsof -i :3000\n# Kill the process\nkill -9 <PID>\n```\n\n**MCP Connection Issues:**\n```bash\n# Test MCP server directly\nnpx @modelcontextprotocol/inspector npx @ai-mapping/mcp-nextjs-dev\n```\n\n**Debug Mode:**\n```bash\n# Enable detailed logging\nDEBUG=1 npx @ai-mapping/mcp-nextjs-dev --debug\n```\n\n### Getting Help\n\n- 📚 [MCP Documentation](https://github.com/modelcontextprotocol/typescript-sdk)\n- 🐛 [Report Issues](https://github.com/ai-mapping/mcp-nextjs-dev/issues)\n- 💬 [Discussions](https://github.com/ai-mapping/mcp-nextjs-dev/discussions)\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Links\n\n- 🏠 [Homepage](https://github.com/ai-mapping/mcp-nextjs-dev)\n- 📦 [NPM Package](https://www.npmjs.com/package/@ai-mapping/mcp-nextjs-dev)\n- 🚀 [AI Mapping Organization](https://github.com/ai-mapping)\n\n---\n\nMade with ❤️ by the [AI Mapping](https://github.com/ai-mapping) team","readmeFilename":"README.md","_rev":"1-bd3da2cf096dfc996e1f9f60d06a177d"}