contextplus (For Loop Codes)

背景+

面向大规模工程的语义智能。

Context+是一个MCP服务器，专为要求99%准确率的开发人员而设计。通过结合RAG、树型AST、光谱聚类和黑曜石风格链接，Context+将庞大的代码库转化为可搜索的分层特征图。

https://github.com/user-attachments/assets/a97a451f-c9b4-468d-b036-15b65fc13e79

工具

发现

分析

代码操作

版本控制

内存和RAG

设置

快速入门（npx/bunx）

无需安装。将Context+添加到IDE MCP配置中。

对于Claude Code、Cursor和Windsurf，请使用 mcpServers:

{
  "mcpServers": {
    "contextplus": {
      "command": "bunx",
      "args": ["contextplus"],
      "env": {
        "OLLAMA_EMBED_MODEL": "nomic-embed-text",
        "OLLAMA_CHAT_MODEL": "gemma2:27b",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY"
      }
    }
  }
}

VS代码(.vscode/mcp.json)，使用 servers 和 inputs:

{
  "servers": {
    "contextplus": {
      "type": "stdio",
      "command": "bunx",
      "args": ["contextplus"],
      "env": {
        "OLLAMA_EMBED_MODEL": "nomic-embed-text",
        "OLLAMA_CHAT_MODEL": "gemma2:27b",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY"
      }
    }
  },
  "inputs": []
}

如果你喜欢 npx，使用：

• "command": "npx"
• "args": ["-y", "contextplus"]

或者直接在当前目录中生成MCP配置文件：

npx -y contextplus init claude
bunx contextplus init cursor
npx -y contextplus init opencode

支持的编码代理名称： claude, cursor, vscode, windsurf, opencode.

配置文件位置：

CLI子命令

• init [target] -生成MCP配置（目标： claude, cursor, vscode, windsurf, opencode).
• skeleton [path] 或 tree [path] - 新 直接在终端中查看具有文件头和符号定义的项目结构树。
• [path] -启动指定路径（默认为当前目录）的MCP服务器（stdio）。

来自源头

npm install
npm run build

嵌入提供者

Context+支持两个由控制的嵌入后端 CONTEXTPLUS_EMBED_PROVIDER:

Ollama（默认）

无需额外配置。只需使用嵌入模型运行Ollama：

ollama pull nomic-embed-text
ollama serve

谷歌双子座（免费版）

完整的克劳德代码 .mcp.json 例子：

{
  "mcpServers": {
    "contextplus": {
      "command": "npx",
      "args": ["-y", "contextplus"],
      "env": {
        "CONTEXTPLUS_EMBED_PROVIDER": "openai",
        "CONTEXTPLUS_OPENAI_API_KEY": "YOUR_GEMINI_API_KEY",
        "CONTEXTPLUS_OPENAI_BASE_URL": "https://generativelanguage.googleapis.com/v1beta/openai",
        "CONTEXTPLUS_OPENAI_EMBED_MODEL": "text-embedding-004"
      }
    }
  }
}

在获取免费API密钥 谷歌人工智能工作室.

开放人工智能

{
  "mcpServers": {
    "contextplus": {
      "command": "npx",
      "args": ["-y", "contextplus"],
      "env": {
        "CONTEXTPLUS_EMBED_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-...",
        "OPENAI_EMBED_MODEL": "text-embedding-3-small"
      }
    }
  }
}

其他与OpenAI兼容的API（Groq、vLLM、LiteLLM）

任何实现 OpenAI嵌入API 作品：

{
  "mcpServers": {
    "contextplus": {
      "command": "npx",
      "args": ["-y", "contextplus"],
      "env": {
        "CONTEXTPLUS_EMBED_PROVIDER": "openai",
        "CONTEXTPLUS_OPENAI_API_KEY": "YOUR_KEY",
        "CONTEXTPLUS_OPENAI_BASE_URL": "https://your-proxy.example.com/v1",
        "CONTEXTPLUS_OPENAI_EMBED_MODEL": "your-model-name"
      }
    }
  }
}

注： 这个 semantic_navigate 该工具还使用聊天模型进行集群标记。使用时 openai 提供者，set CONTEXTPLUS_OPENAI_CHAT_MODEL （默认值： gpt-4o-mini). 对于VS代码、游标或OpenCode，使用相同的 env IDE MCP配置格式中的块（请参阅 配置文件位置 上表）。

建筑

使用模型上下文协议SDK在stdio上使用TypeScript构建的三层：

核心 (src/core/)-多语言AST解析（树形图，43个扩展）、gitignore感知遍历、带磁盘缓存的Ollama向量嵌入、wikilink中心图、带衰减评分的内存属性图。

工具 (src/tools/)-17个MCP工具，展示结构、语义、操作和内存图功能。

Git (src/git/)-影子还原点系统，用于撤消操作，无需接触git历史记录。

运行时缓存 (.mcp_data/)-在服务器启动时创建；存储可重用的文件、标识符和调用站点嵌入，以避免重复的GPU/CPU嵌入工作。实时跟踪器增量刷新更改的文件/函数。

配置

测试

npm test
npm run test:demo
npm run test:all