MCP 服务代码编写与重构★ 47.3k

codebase-memory-mcp

项目主页

能做什么

本地代码智能工具连接代码/文档/基础设施，提供 MCP 工具与变更感知测试选择

为开发者和 AI agents 提供的本地代码智能。将代码、文档和基础设施连接到一个持久图谱中，并提供 CBM Lens、MCP 工具、agent 集成以及变更感知的测试选择。

一键部署

MCP 服务会以你的权限运行代码或访问你的数据。安装前请先看项目主页与源码，只给必要的权限；密钥请自行填入，不要提交到仓库。

一键添加到 Cursor 一键添加到 VS Code需本机已安装对应客户端；跳转后请在客户端里确认并填入密钥

Claude Code（终端执行）

claude mcp add codebase-memory-mcp -- npx -y codebase-memory-mcp@0.12.1

通用 JSON 配置（Claude Desktop / Cursor / Cline 等的 mcpServers）

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "codebase-memory-mcp@0.12.1"
      ]
    }
  }
}

怎么使用

摘自项目自己的说明，具体以项目主页为准。

Quick Start

Install the latest release (macOS / Linux):

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

The standard native release includes CBM Lens. Start it after installation with codebase-memory-mcp daemon start --open --port=9749. The Nix packages and source builds also offer builds without the UI.

Windows (PowerShell):

# 1. Download the installer
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

# 2. (Optional but recommended) Inspect the script
notepad install.ps1

# 3. Unblock the downloaded file (removes Mark-of-the-Web restriction added by browsers/Invoke-WebRequest)
Unblock-File .\install.ps1

# 4. Run it
.\install.ps1

Note: If you see a script execution policy error, run Set-ExecutionPolicy -Scope Process Bypass first, or invoke with PowerShell -ExecutionPolicy Bypass -File .\install.ps1.

Options: --skip-config (binary only, no agent setup), --dir= (custom location).

Antivirus note: Microsoft Defender may flag a release binary as Trojan:Script/Wacatac.B!ml. This is a known false positive; typically 61 of ~62 engines return clean, and the same detection family hits gh, llama.cpp, Godot and Microsoft's own Go toolchain. See Antivirus False Positives for the evidence, how to verify the artifacts yourself, and how to report it if you think we are wrong.

Restart your coding agent. Say "Index this project": done.

Manual install

Download the archive for your platform from the latest release:
- codebase-memory-mcp--.tar.gz (macOS/Linux) or .zip (Windows)

Extract and install (each archive includes install.sh or install.ps1):

macOS / Linux:

tar xzf codebase-memory-mcp-*.tar.gz
./install.sh

Windows (PowerShell):

Expand-Archive codebase-memory-mcp-windows-amd64.zip -DestinationPath .
Unblock-File .\install.ps1
.\install.ps1

Restart your coding agent.

The install command automatically strips macOS quarantine attributes and ad-hoc signs the binary; no manual xattr/codesign needed.

Agent setup: skills, profiles, and hooks

…