Skip to content
Back to search

codebase-mcp

Model Context Protocol implementation for retrieving codebases using RepoMix

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dedeveloper23--codebase-mcp/badge.svg)](/listings/dedeveloper23--codebase-mcp)

HTML

<a href="/listings/dedeveloper23--codebase-mcp"><img src="/api/listings/dedeveloper23--codebase-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From NPM (Recommended)

# Install the package globally
npm install -g codebase-mcp

# Install RepoMix (required dependency)
codebase-mcp install

From GitHub

# Clone the repository
git clone https://github.com/DeDeveloper23/codebase-mcp.git

# Navigate to the project directory
cd codebase-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Install globally
npm install -g .

# Install RepoMix (required dependency)
codebase-mcp install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Codebase MCP
  2. A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server implementation that provides tools to retrieve and analyze entire codebases using [RepoMix](https://repomix.com/).
  3. This MCP allows AI Agents like Cursor's Composer Agent to automatically read and understand entire codebases at once, making it easier for developers to work with large codebases and for AI assistants to have comprehensive context of a project.
  4. ## Features
  5. - 📚 **Codebase Retrieval**: Retrieve the entire codebase as a single text output in different formats (XML, Markdown, Plain)
  6. - 🌐 **Remote Repository Support**: Process remote GitHub repositories directly
  7. - 💾 **File Saving**: Save the processed codebase to a file
  8. - 🔧 **Customizable Options**: Control how the codebase is processed with various options (comments, line numbers, file summaries, etc.)
  9. ## Installation
  10. ### From NPM (Recommended)
  11. ```bash
  12. # Install the package globally
  13. npm install -g codebase-mcp
  14. # Install RepoMix (required dependency)
  15. codebase-mcp install
  16. ```
  17. ### From GitHub
  18. ```bash
  19. # Clone the repository
  20. git clone https://github.com/DeDeveloper23/codebase-mcp.git
  21. # Navigate to the project directory
  22. cd codebase-mcp
  23. # Install dependencies
  24. npm install
  25. # Build the project
  26. npm run build
  27. # Install globally
  28. npm install -g .
  29. # Install RepoMix (required dependency)
  30. codebase-mcp install
  31. ```
  32. ## Integration with Cursor
  33. To use this MCP with Cursor's Composer Agent:
  34. 1. Open Cursor IDE
  35. 2. Click the Composer icon in the sidebar
  36. 3. Click the "MCP Servers" button at the top
  37. 4. Click "Add new MCP server"
  38. 5. Fill in the details:
  39. - Name: `Codebase MCP` (or any name you prefer)
  40. - Type: `command`
  41. - Command: `codebase-mcp start`
  42. 6. Click "Add" to save
  43. Once added, the MCP will provide three powerful tools to the Composer Agent:
  44. ### Available Tools
  45. 1. **getCodebase**
  46. - Purpose: Analyzes your current workspace/project
  47. - Use when: You want the AI to understand your entire codebase
  48. - Example prompt: "Please analyze my codebase to understand its structure"
  49. 2. **getRemoteCodebase**
  50. - Purpose: Fetches and analyzes any public GitHub repository
  51. - Use when: You want to explore or understand other projects
  52. - Example prompt: "Can you analyze the repository at github.com/username/repo?"
  53. 3. **saveCodebase**
  54. - Purpose: Saves the codebase analysis to a file for later use
  55. - Use when: You want to preserve the codebase snapshot or share it
  56. - Example prompt: "Save an analysis of this codebase to review later"
  57. ### Example Usage in Cursor
  58. Here are some example prompts you can use with the Composer Agent:
  59. ```
  60. "Analyze my current project and explain its main components."
  61. "Can you look at the tensorflow/tensorflow repository and explain how their testing framework works?"
  62. "Save an analysis of my project to 'codebase-analysis.md' in markdown format."
  63. ```
  64. The Composer Agent will automatically use the appropriate tool based on your request.
  65. ## Usage Outside Cursor
  66. ### Starting the MCP Server
  67. ```bash
  68. codebase-mcp start
  69. ```
  70. This will start the MCP server in stdio mode, which can be used by any MCP-compatible clients.
  71. ## License
  72. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.