Code Context MCP Server

Code Context MCP 服务

一个 Model Context Protocol (MCP) 服务，用于从本地 git 仓库提供代码上下文。该服务允许你：

1. 在本地克隆 git 仓库
2. 处理分支和文件
3. 为代码块生成嵌入
4. 对代码执行语义搜索

功能

• 使用本地 git 仓库，而非 GitHub API
• 将数据存储在 SQLite 数据库中
• 将代码拆分为语义块
• 使用 Ollama 为代码块生成嵌入
• 提供对代码的语义搜索

先决条件

• Node.js (v16+)
• Git
• 带有嵌入模型的 Ollama

安装

# Clone the repository
git clone <repository-url>
cd code-context-mcp

# Install dependencies
npm install

# Build the project
npm run build

配置

设置以下环境变量：

• DATA_DIR：SQLite 数据库的目录（默认：'~/.codeContextMcp/data'）
• REPO_CACHE_DIR：克隆仓库的目录（默认：'~/.codeContextMcp/repos'）

使用 Ollama

为了获得更快、更强大的嵌入，你可以使用 Ollama：

# Install Ollama from https://ollama.ai/

# Pull an embedding model (unclemusclez/jina-embeddings-v2-base-code is recommended)
ollama pull unclemusclez/jina-embeddings-v2-base-code

用法

与 Claude Desktop 一起使用

将以下配置添加到你的 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "code-context-mcp": {
      "command": "/path/to/your/node",
      "args": ["/path/to/code-context-mcp/dist/index.js"]
    }
  }
}

工具

该服务提供以下工具：

queryRepo

克隆仓库、处理代码并执行语义搜索：

{
  "repoUrl": "https://github.com/username/repo.git",
  "branch": "main", // Optional - defaults to repository's default branch
  "query": "Your search query",
  "keywords": ["keyword1", "keyword2"], // Optional - filter results by keywords
  "filePatterns": ["**/*.ts", "src/*.js"], // Optional - filter files by glob patterns
  "excludePatterns": ["**/node_modules/**"], // Optional - exclude files by glob patterns
  "limit": 10 // Optional - number of results to return, default: 10
}

branch 参数是可选的。如果未提供，该工具将自动使用仓库的默认分支。

keywords 参数是可选的。如果提供，结果将被过滤为仅包含至少一个指定关键词的代码块（不区分大小写匹配）。

filePatterns 和 excludePatterns 参数是可选的。它们允许你使用 glob 模式（例如 **/*.ts 表示所有 TypeScript 文件）来过滤要处理和搜索的文件。

数据库架构

该服务使用 SQLite，架构如下：

• repository：存储仓库相关信息
• branch：存储分支相关信息
• file：存储文件相关信息
• branch_file_association：将文件与分支关联
• file_chunk：存储代码块及其嵌入

调试

MAC Mx 系列 - ARM 架构问题

在 Mac M 系列芯片（ARM 架构）上安装 better-sqlite3 时，如果遇到诸如 "mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e' or 'arm64')" 的错误，你需要确保二进制文件与你的架构匹配。以下是解决此问题的方法：

# Check your Node.js architecture
node -p "process.arch"

# If it shows 'arm64', but you're still having issues, try:
npm rebuild better-sqlite3 --build-from-source

# Or for a clean install:
npm uninstall better-sqlite3
export npm_config_arch=arm64
export npm_config_target_arch=arm64
npm install better-sqlite3 --build-from-source

如果你使用 Rosetta，请确保你的整个环境保持一致。你的错误显示正在构建 x86_64 二进制文件，但你的系统需要 arm64。 如需持久配置，请添加到你的 .zshrc 或 .bashrc：

export npm_config_arch=arm64
export npm_config_target_arch=arm64

测试 Ollama 嵌入

curl http://localhost:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}' curl http://127.0.01:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}' curl http://[::1]:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'

许可证

MIT