codebase-mcp

概述

Codebase MCP 是一个开源开发助手，通过模型上下文协议与 Claude Desktop 集成。它提供 13 种专业工具用于代码库管理，包括语义搜索、持久化记忆、智能代码编写与自动格式化，以及基于会话的 Git 工作流。系统几乎完全在本地运行，仅使用 Google 的 Gemini API 进行 AI 辅助编辑操作。它设计为付费编码助手（如 Cursor）的免费替代方案，利用现有的 Claude 订阅。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• session_tool

  Manage development sessions with automatic branch creation and commits

  试试:Create a new session for the payment feature试试:Check my current session status
• memory_tool

  Store and retrieve persistent knowledge across chat sessions

  试试:Remember that I use async/await patterns试试:Show me previous mistakes I've made
• git_tool

  Perform Git operations including status, diff, commit and branch management

  试试:Show me the changes in this branch试试:Commit these changes with a descriptive message
• write_tool

  Create new files with auto-formatting and quality scoring

  试试:Create a new user authentication module试试:Write a test file for the payment processor
• edit_file

  AI-assisted file editing with Gemini-powered suggestions

  试试:Refactor this function to use dependency injection试试:Fix the bug in this authentication logic
• search_tool

  Perform semantic code search across the entire codebase

  试试:Find all user-related functions试试:Search for database connection patterns
• read_code_tool

  Read code with symbol-level precision and line range support

  试试:Read the entire UserService class试试:Show me lines 10-25 of the payment processor
• project_context_tool

  Analyze project structure and dependencies

  试试:Give me an overview of this project试试:Identify all third-party dependencies
• list_directory_tool

  Explore directory structures with tree views and metadata

  试试:Show me the src directory structure试试:List all Python files in the project
• code_analysis_tool

  Perform code quality checks including syntax, linting and dependencies

  试试:Check this file for linting issues试试:Analyze the code quality of the auth module
• list_file_symbols_tool

  Extract functions, classes and interfaces from source files

  试试:List all symbols in this file试试:Show me all public methods in the Service class
• project_structure_tool

  Visualize project structure with enhanced tree views and statistics

  试试:Visualize the entire project structure试试:Show me a breakdown of file types and sizes

可对比工具

安装

git clone https://github.com/danyQe/codebase-mcp.git
cd codebase-mcp

# 如果尚未安装 uv
pip install uv

# 创建虚拟环境并安装依赖
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

# 全局安装格式化工具
pip install black ruff

cp .env.example .env
# 从 https://aistudio.google.com/app/apikey 获取免费 API 密钥
# 添加到 .env 文件：
GEMINI_API_KEY=your_api_key_here

{
  "mcpServers": {
    "codebase-manager": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/codebase-mcp/mcp_server.py"
      ]
    }
  }
}

python main.py /path/to/your/project

FAQ

Codebase MCP 与 Cursor 相比如何？

Codebase MCP 是一个开源替代方案，它使用您现有的 Claude 订阅，而不需要单独支付 20-40 美元/月的费用。它提供类似的功能，如语义搜索和 AI 辅助编辑，同时是隐私优先的，所有处理都在本地进行。

哪些数据会发送到外部服务？

只有 edit_file 工具使用 Google 的 Gemini API，并且只发送正在编辑的特定文件（不发送项目上下文或历史记录）。所有其他操作，包括嵌入、搜索和内存处理，都在您的本地机器上运行。

codebase-mcp 对比