MCP 服务器

Code Context MCP Server

一个 MCP 服务器，提供对本地 Git 仓库的语义搜索，使用户能够克隆仓库、处理分支，并通过向量化的代码块搜索代码。

README

Code Context MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于从本地 git 仓库提供代码上下文。此服务器允许您：

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

功能

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

前提条件

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

安装

# 克隆仓库
git clone <repository-url>
cd code-context-mcp

# 安装依赖
npm install

# 构建项目
npm run build

配置

设置以下环境变量：

DATA_DIR: SQLite 数据库的目录 (默认: '~/.codeContextMcp/data')
REPO_CACHE_DIR: 克隆仓库的目录 (默认: '~/.codeContextMcp/repos')

使用 Ollama

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

# 从 https://ollama.ai/ 安装 Ollama

# 拉取一个嵌入模型 (推荐使用 unclemusclez/jina-embeddings-v2-base-code)
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", // 可选 - 默认为仓库的默认分支
  "query": "您的搜索查询",
  "keywords": ["keyword1", "keyword2"], // 可选 - 按关键字过滤结果
  "filePatterns": ["**/*.ts", "src/*.js"], // 可选 - 按 glob 模式过滤文件
  "excludePatterns": ["**/node_modules/**"], // 可选 - 按 glob 模式排除文件
  "limit": 10 // 可选 - 返回的结果数量，默认: 10
}

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

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

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

数据库模式

服务器使用具有以下模式的 SQLite：

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

调试

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"}'