{"_id":"coderabbitai-mcp","_rev":"3-f45f20970f78c93124b6c477efbaa839","name":"coderabbitai-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"coderabbitai-mcp","version":"1.0.0","keywords":["mcp","coderabbit","github","ai","code-review","model-context-protocol","llm","claude","typescript","automation","pull-request","review-comments","npx"],"author":{"name":"Claude Code"},"license":"MIT","_id":"coderabbitai-mcp@1.0.0","maintainers":[{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com"}],"homepage":"https://github.com/bradthebeeble/coderabbitai-mcp#readme","bugs":{"url":"https://github.com/bradthebeeble/coderabbitai-mcp/issues"},"bin":{"coderabbitai-mcp":"dist/index.js"},"dist":{"shasum":"c65428de8b33f0cea5011b92c6e863347f247ded","tarball":"https://registry.npmjs.org/coderabbitai-mcp/-/coderabbitai-mcp-1.0.0.tgz","fileCount":44,"integrity":"sha512-0bLMy8XMGr7qmWKZrKC6dLpyJPaHsI2giXbe6QIPDTU8OwZBUagKEkFMPA+bLoBk8YSvRyrF4D3//EZJmi1hIQ==","signatures":[{"sig":"MEYCIQCpAB9afmMg1ANoQejXYPwuUnguLs2HkqE5ToJu8nSe2gIhAPBdSXEYfzJUOi8n1gHg0Eozrd2sIbZrgKbQ4vvE1tk1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":143594},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d58686762bae13af7afe535d82d6e87169dd3c09","scripts":{"dev":"tsc --watch","test":"node --version && echo 'Node.js OK' && node dist/index.js --version || echo 'Server test completed'","build":"tsc && chmod 755 dist/index.js","clean":"rm -rf dist","start":"node dist/index.js","publish-npm":"npm run prepublishOnly && npm publish","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"bradthebeeble","actor":{"name":"bradthebeeble","type":"user","email":"asaf.atzmon@gmail.com"},"email":"asaf.atzmon@gmail.com"},"repository":{"url":"git+https://github.com/bradthebeeble/coderabbitai-mcp.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for interacting with CodeRabbit AI reviews on GitHub pull requests. Enables LLMs to analyze, implement, and resolve CodeRabbit suggestions programmatically.","directories":{},"_nodeVersion":"20.15.1","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/coderabbitai-mcp_1.0.0_1751187409371_0.3229474799995289","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"coderabbitai-mcp","version":"1.1.0","keywords":["mcp","coderabbit","github","ai","code-review","model-context-protocol","llm","claude","typescript","automation","pull-request","review-comments","npx"],"author":{"name":"Claude Code"},"license":"MIT","_id":"coderabbitai-mcp@1.1.0","maintainers":[{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com"}],"homepage":"https://github.com/bradthebeeble/coderabbitai-mcp#readme","bugs":{"url":"https://github.com/bradthebeeble/coderabbitai-mcp/issues"},"bin":{"coderabbitai-mcp":"dist/index.js"},"dist":{"shasum":"fe4802bc75d84baac1c8779a5d3525475a3844f1","tarball":"https://registry.npmjs.org/coderabbitai-mcp/-/coderabbitai-mcp-1.1.0.tgz","fileCount":43,"integrity":"sha512-NSwtNDG+nW/IJ98x3CyudyksCe28PsY7OR0WhF59NZHKN71h7Ov6LJEnadQQuaHc7Vw21XTlZjrucNud+tNBVw==","signatures":[{"sig":"MEUCIQDPRpLbs0bsiaUO0RiryMnwZazIEfLjSZvneawamMumpgIgIp5b/zGFp7cmDDdVa4U4AElArudhjv14RX2l0klm1aw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138082},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"fd8343aac4d139ea0637e6bbafe09dda448e4851","scripts":{"dev":"tsc --watch","test":"node --version && echo 'Node.js OK' && node dist/index.js --version || echo 'Server test completed'","build":"tsc && chmod 755 dist/index.js","clean":"rm -rf dist","start":"node dist/index.js","publish-npm":"npm run prepublishOnly && npm publish","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"bradthebeeble","actor":{"name":"bradthebeeble","type":"user","email":"asaf.atzmon@gmail.com"},"email":"asaf.atzmon@gmail.com"},"repository":{"url":"git+https://github.com/bradthebeeble/coderabbitai-mcp.git","type":"git"},"_npmVersion":"10.8.3","description":"MCP server for interacting with CodeRabbit AI reviews on GitHub pull requests. Enables LLMs to analyze, implement, and resolve CodeRabbit suggestions programmatically.","directories":{},"_nodeVersion":"20.15.1","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/coderabbitai-mcp_1.1.0_1751208542087_0.05421082431828772","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"coderabbitai-mcp","version":"1.1.1","description":"MCP server for interacting with CodeRabbit AI reviews on GitHub pull requests. Enables LLMs to analyze, implement, and resolve CodeRabbit suggestions programmatically.","main":"dist/index.js","type":"module","bin":{"coderabbitai-mcp":"dist/index.js"},"scripts":{"build":"tsc && chmod 755 dist/index.js","dev":"tsc --watch","start":"node dist/index.js","clean":"rm -rf dist","test":"node --version && echo 'Node.js OK' && node dist/index.js --version || echo 'Server test completed'","prepublishOnly":"npm run clean && npm run build","publish-npm":"npm run prepublishOnly && npm publish"},"keywords":["mcp","coderabbit","github","ai","code-review","model-context-protocol","llm","claude","typescript","automation","pull-request","review-comments","npx"],"author":{"name":"Claude Code"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bradthebeeble/coderabbitai-mcp.git"},"homepage":"https://github.com/bradthebeeble/coderabbitai-mcp#readme","bugs":{"url":"https://github.com/bradthebeeble/coderabbitai-mcp/issues"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"coderabbitai-mcp@1.1.1","gitHead":"2cc9f5b60d8aa8da901d83eb720ef0c778d9dbc3","types":"./dist/index.d.ts","_nodeVersion":"20.15.1","_npmVersion":"10.8.3","dist":{"integrity":"sha512-qLqzPerE4krW7yoX9W9iR0I+w8lj7EEzLvWb3q4Uz9F0S21wDAsOYuP/fmnr+fbb0JQUIyiqxzuhN5XwUnhdaA==","shasum":"086a3597ae2df4d11f4c0a2cc1976dbb2c857a53","tarball":"https://registry.npmjs.org/coderabbitai-mcp/-/coderabbitai-mcp-1.1.1.tgz","fileCount":43,"unpackedSize":138466,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCgXHghKKag7DvprUGEgbxLBZXS0BqUx6NRS+Qow6xGLgIgR2WUlGyLWN8fj7gutLXqFjYEuNT6/MiEh2VTaOOTPdc="}]},"_npmUser":{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com","actor":{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/coderabbitai-mcp_1.1.1_1751213874453_0.3938751916374523"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-29T08:56:49.371Z","modified":"2025-06-29T16:17:54.882Z","1.0.0":"2025-06-29T08:56:49.566Z","1.1.0":"2025-06-29T14:49:02.282Z","1.1.1":"2025-06-29T16:17:54.640Z"},"bugs":{"url":"https://github.com/bradthebeeble/coderabbitai-mcp/issues"},"author":{"name":"Claude Code"},"license":"MIT","homepage":"https://github.com/bradthebeeble/coderabbitai-mcp#readme","keywords":["mcp","coderabbit","github","ai","code-review","model-context-protocol","llm","claude","typescript","automation","pull-request","review-comments","npx"],"repository":{"type":"git","url":"git+https://github.com/bradthebeeble/coderabbitai-mcp.git"},"description":"MCP server for interacting with CodeRabbit AI reviews on GitHub pull requests. Enables LLMs to analyze, implement, and resolve CodeRabbit suggestions programmatically.","maintainers":[{"name":"bradthebeeble","email":"asaf.atzmon@gmail.com"}],"readme":"# CodeRabbit MCP Server\n\nA Model Context Protocol (MCP) server for interacting with CodeRabbit AI reviews on GitHub pull requests. This server enables Large Language Models (LLMs) to analyze, understand, and implement CodeRabbit suggestions programmatically.\n\n## Features\n\n- **Get CodeRabbit Reviews**: Retrieve all CodeRabbit reviews for a specific pull request\n- **Review Details**: Get detailed information about specific reviews including configuration and files reviewed\n- **Extract Comments**: Get individual line comments with AI prompts and suggestions\n- **Comment Details**: Deep dive into specific comments with context and fix examples\n- **Resolve Comments**: Mark comments as addressed, won't fix, or not applicable\n- **Automated Workflow Prompt**: Use `/coderabbit-review` slash command for complete review processing\n\n## Quick Start\n\n### Installation (NPX - Recommended)\n\nNo installation required! Run directly with npx:\n\n```bash\n# Install the latest stable version explicitly\nnpx coderabbitai-mcp@latest\n```\n\n### Prerequisites\n\n1. **GitHub Personal Access Token**: Create at <https://github.com/settings/tokens>\n   - Required scopes: `repo` (for private repos) or `public_repo` (for public only)\n2. **Node.js 18+**: Required for running the server\n\n<details>\n<summary>Configuration</summary>\n\n### Claude Desktop\n\nAdd 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    \"coderabbitai\": {\n      \"command\": \"npx\",\n      \"args\": [\"coderabbitai-mcp\"],\n      \"env\": {\n        \"GITHUB_PAT\": \"ghp_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to your project's `.claude/config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"coderabbitai\": {\n      \"command\": \"npx\",\n      \"args\": [\"coderabbitai-mcp\"],\n      \"env\": {\n        \"GITHUB_PAT\": \"ghp_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n## Usage\n\n### Automated Review Processing (Recommended)\n\nUse the built-in MCP prompt for complete workflow automation:\n\n```text\n/coderabbit-review owner:bradthebeeble repo:wiseguys pullNumber:15\n```\n\nThis prompt automatically:\n- Finds and analyzes CodeRabbit reviews\n- Classifies issues by priority (high/medium/low)\n- Gets your approval before making changes\n- Systematically implements fixes\n- Marks resolved comments in CodeRabbit\n- Provides a completion summary\n\n### Manual Tool Usage\n\n<details>\n<summary>Available Tools</summary>\n\n#### 1. `get_coderabbit_reviews`\nGet all CodeRabbit reviews for a specific pull request.\n\n```json\n{\n  \"owner\": \"bradthebeeble\",\n  \"repo\": \"wiseguys\", \n  \"pullNumber\": 15\n}\n```\n\n#### 2. `get_review_details`\nGet detailed information about a specific CodeRabbit review.\n\n```json\n{\n  \"owner\": \"bradthebeeble\",\n  \"repo\": \"wiseguys\",\n  \"pullNumber\": 15,\n  \"reviewId\": 2969007538\n}\n```\n\n#### 3. `get_review_comments`\nGet all individual line comments from CodeRabbit reviews.\n\n```json\n{\n  \"owner\": \"bradthebeeble\",\n  \"repo\": \"wiseguys\",\n  \"pullNumber\": 15,\n  \"reviewId\": 2969007538\n}\n```\n\n#### 4. `get_comment_details`\nGet detailed information about a specific CodeRabbit comment.\n\n```json\n{\n  \"owner\": \"bradthebeeble\",\n  \"repo\": \"wiseguys\",\n  \"commentId\": 2173534099\n}\n```\n\n#### 5. `resolve_comment`\nMark a CodeRabbit comment as resolved.\n\n```json\n{\n  \"owner\": \"bradthebeeble\", \n  \"repo\": \"wiseguys\",\n  \"commentId\": 2173534099,\n  \"resolution\": \"addressed\",\n  \"note\": \"Implemented asyncHandler wrapper as suggested\"\n}\n```\n\n</details>\n\n<details>\n<summary>Development Installation</summary>\n\nFor development or local customization:\n\n```bash\ngit clone https://github.com/bradthebeeble/coderabbitai-mcp.git\ncd coderabbitai-mcp\nnpm install\nnpm run build\n```\n\n### Development Commands\n\n```bash\n# Build TypeScript\nnpm run build\n\n# Watch mode for development\nnpm run dev\n\n# Clean build files\nnpm run clean\n\n# Test the server\nnpm test\n```\n\n</details>\n\n<details>\n<summary>Environment Variables</summary>\n\nCreate a `.env` file (optional):\n\n```bash\n# GitHub Configuration (shorter variable name)\nGITHUB_PAT=ghp_your_token_here\n\n# Optional: CodeRabbit MCP Configuration\nCODERABBIT_LOG_LEVEL=info\n```\n\n</details>\n\n<details>\n<summary>Troubleshooting</summary>\n\n### Common Issues\n\n**Server not loading (NPX):**\n- Verify Node.js 18+ is installed: `node --version`\n- Test npx execution manually: `npx coderabbitai-mcp` \n- Check your internet connection (npx downloads the latest version)\n\n**GitHub API errors:**\n- Verify your GitHub token has the required permissions\n- Check that you have access to the repositories you're querying\n\n**No CodeRabbit reviews found:**\n- Verify the PR has CodeRabbit reviews (check GitHub web interface)\n- Ensure you're using the correct owner/repo/pullNumber\n\n### Debug Mode\n\nEnable debug logging:\n\n```bash\nCODERABBIT_LOG_LEVEL=debug npx coderabbitai-mcp\n```\n\n</details>\n\n## Integration Requirements\n\n### Supported AI Clients\n\n- **Claude Desktop**: Full support with configuration\n- **Claude Code**: Project-level MCP integration with `/coderabbit-review` prompt\n- **Other MCP Clients**: Any client supporting the Model Context Protocol\n\n### Authentication\n\nThe GitHub Personal Access Token needs these permissions:\n- `repo` (for private repositories) or `public_repo` (for public only)\n- `read:org` (if accessing organization repositories)\n\n## Architecture\n\n- **TypeScript**: Fully typed implementation with Zod validation\n- **MCP SDK**: Built on the official Model Context Protocol SDK\n- **Modular Design**: Each tool is implemented in its own module\n- **MCP Prompts**: Automated workflows available as slash commands\n\n## API Rate Limits\n\nThe server respects GitHub's API rate limits:\n- 5,000 requests/hour for authenticated requests\n- Automatically handles rate limit responses\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes and add tests\n4. Run the build: `npm run build`\n5. Submit a pull request\n\n## License\n\nMIT\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/bradthebeeble/coderabbitai-mcp/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/bradthebeeble/coderabbitai-mcp/discussions)\n- **Documentation**: Full examples available in [EXAMPLES.md](./EXAMPLES.md)","readmeFilename":"README.md"}