CodebaseBLOCK
Model Context Protocol implementation for retrieving codebases using RepoMix
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A Model Context Protocol (MCP) server implementation that provides tools to retrieve and analyze entire codebases using RepoMix.
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.
Features
- 📚 Codebase Retrieval: Retrieve the entire codebase as a single text output in different formats (XML, Markdown, Plain)
- 🌐 Remote Repository Support: Process remote GitHub repositories directly
- 💾 File Saving: Save the processed codebase to a file
- 🔧 Customizable Options: Control how the codebase is processed with various options (comments, line numbers, file summaries, etc.)
Installation
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
Integration with Cursor
To use this MCP with Cursor's Composer Agent:
- Open Cursor IDE
- Click the Composer icon in the sidebar
- Click the "MCP Servers" button at the top
- Click "Add new MCP server"
- Fill in the details:
- Name:
Codebase MCP(or any name you prefer) - Type:
command - Command:
codebase-mcp start - Click "Add" to save
Once added, the MCP will provide three powerful tools to the Composer Agent:
Available Tools
- getCodebase
- Purpose: Analyzes your current workspace/project
- Use when: You want the AI to understand your entire codebase
- Example pro
b5b7cda4980eOBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add codebase-mcp -- npx -y [email protected]
{
"mcpServers": {
"codebase-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (3)
2 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
getCodebase | read | Retrieve the entire codebase as a single text output using RepoMix |
getRemoteCodebase | read | Retrieve a remote repository |
saveCodebase | write | Save the codebase to a file using RepoMix |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (5 observation(s))
- Shell
- declared (5 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (13)
: /* list inspired by the default env inheritance of sudo */
import { OAuthClientInformationFull } from "../../shared/auth.js";import { OAuthErrorResponse } from "../../shared/auth.js";import { OAuthClientInformationFull, OAuthTokens } from '../../../shared/auth.js';import { OAuthMetadata } from '../../../shared/auth.js';import { OAuthMetadata } from "../../../shared/auth.js";baseUrl = new URL(`http://127.0.0.1:${addr.port}`);baseUrl = new URL(`http://127.0.0.1:${addr.port}`);baseUrl = new URL(`http://127.0.0.1:${addr.port}`);baseUrl = new URL(`http://127.0.0.1:${addr.port}`);baseUrl = new URL(`http://127.0.0.1:${addr.port}`);@modelcontextprotocol/sdk, content-type, cors, eventsource, express, express-rate-limit, pkce-challenge, raw-body
system use found in code, not declared in the description
Gates applied: no_behavioural_pass.
b5b7cda4980efull audit observations/trust-audit/mcp-server/dedeveloper23__codebase.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | b5b7cda4980e | BLOCK | D | 69 | first audit |
Questions
What is the Codebase MCP server?
Model Context Protocol implementation for retrieving codebases using RepoMix
What tools does Codebase expose?
3 in total: 2 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Codebase safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does Codebase need?
No credential environment variables were found in its source, so it appears to need none.
How does Codebase run?
It speaks sse and stdio, so it runs as a local process your client starts. It is published on npm as codebase-mcp at 1.0.0.
How current is this page?
The grade is for one exact copy of the source (b5b7cda4980e), read on 2026-10-07. The repository is watched and re-audited when it changes.