Ctx Sys

MCP搜索检索

提供方 david-franz

搜索检索 未标注 Token 社区 / 第三方 Claude DesktopClaudeCursor

ctx-sys是一个本地混合RAG工具,用于索引代码库并通过语义、关键词和图形检索为AI编程助手提供深度项目理解。

一句话选型结论

按资料字段整理

Ctx Sys 属于搜索检索类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 12 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

代码检索TypeScript本地部署RAG本地AI工具代码理解编程辅助

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ctx Sys当前 12 未标注 未标注 无 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方david-franz上游标注的维护方 david-franz
分类搜索检索本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.7 KB
来自项目仓库与上游目录的原文,未做删改

ctx系统

用于AI编码助手的本地混合RAG。 索引您的代码库,使用语义+关键字+图形检索进行搜索,并让您的AI助手深入了解项目——所有这些都在Ollama本地运行。```bash
npm install -g ctx-sys


## 为什么选择ctx-sys?

AI编码助手受到上下文窗口的限制。他们看不到你的整个代码库,他们忘记了你昨天讨论的内容,他们错过了文件之间的连接。ctx-sys通过充当 *聪明的图书管理员* --它为你的代码建立索引,理解符号之间的关系,并在你的人工智能需要时准确检索正确的上下文。

- **混合动力RAG** --将向量搜索、关键字/FTS5和图遍历与倒排融合相结合
- **本地优先** --你的代码永远不会离开你的机器。Ollama处理嵌入和摘要
- **代码感知** --树型AST解析提取函数、类、导入和关系
- **适用于任何MCP客户端** --Claude Desktop、Claude Code、Cursor或任何与MCP兼容的工具

## 快速入门(5分钟)

### 1.安装```bash
# Install ctx-sys
npm install -g ctx-sys

# Install and start Ollama (for embeddings)
# macOS: brew install ollama
# Linux: curl -fsSL https://ollama.com/install.sh | sh
ollama serve &
ollama pull mxbai-embed-large:latest

2.为你的项目建立索引```bash

cd your-project
ctx-sys init
ctx-sys index


这将使用树形图解析您的代码,使用Ollama生成嵌入,并对任何markdown文档进行索引——所有这些都在一个命令中完成。

### 3.搜索```bash
# Semantic + keyword hybrid search
ctx-sys search "how does authentication work"

# Assembled context with source expansion
ctx-sys context "error handling in the API layer"

# Use HyDE for better conceptual search
ctx-sys search "database connection pooling" --hyde

4.连接到您的AI助手

添加ctx-sys作为MCP服务器。对于 克劳德桌面,添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"ctx-sys": {
"command": "ctx-sys",
"args": ["serve"]
}
}
}


对于 **克劳德代码**,添加到MCP设置中:```json
{
"mcpServers": {
"ctx-sys": {
"command": "ctx-sys",
"args": ["serve"]
}
}
}

现在,你的AI助手可以使用12个基于动作的工具来搜索你的代码库、查询关系图、管理对话记忆等等。

运作原理```

Your Code ctx-sys AI Assistant
───────── ─────── ────────────
.ts .py .rs ──→ AST Parse (tree-sitter)
.md .html ──→ Document Chunking
↓
Entity Extraction
(functions, classes, imports)
↓
Embed with Ollama ←── "How does auth work?"
(mxbai-embed-large) ↓
↓ context_query
┌─────────────┐ ↓
│ SQLite DB │ ┌─────────────────────┐
│ + FTS5 │──────────────→│ Hybrid Search │
│ + vec0 │ │ • Vector similarity│
│ + Graph │ │ • FTS5 keyword │
└─────────────┘ │ • Graph traversal │
└─────────┬───────────┘
↓
Rank & Assemble
↓
Relevant context with
source attribution


## CLI参考

### 核心命令```bash
ctx-sys init [directory]          # Initialize project config
ctx-sys index [directory]         # Index code + docs + embeddings
ctx-sys search             # Hybrid search (semantic + keyword)
ctx-sys context            # Assembled context with expansion
ctx-sys status [directory]        # Project info and health checks
ctx-sys serve                     # Start MCP server
ctx-sys watch [directory]         # Watch files and auto-reindex

关键标志```bash

Index

ctx-sys index --no-doc # Skip document indexing
ctx-sys index --no-embed # Skip embedding generation
ctx-sys index --force # Re-index everything from scratch

Search

ctx-sys search "query" --hyde # Use HyDE for conceptual queries
ctx-sys search "query" --limit 20 # Control result count
ctx-sys search "query" --no-semantic # Keyword-only search

Context

ctx-sys context "query" --max-tokens 8000 # Token budget
ctx-sys context "query" --no-expand # Skip context expansion
ctx-sys context "query" --hyde # HyDE-enhanced retrieval

Status

ctx-sys status --check # Full health diagnostics


### 子指令```bash
# Entity management
ctx-sys entity list               # List indexed entities
ctx-sys entity stats              # Type breakdown
ctx-sys entity get            # Entity details

# Relationship graph
ctx-sys graph query       # Traverse relationships
ctx-sys graph stats               # Graph statistics

# Embeddings
ctx-sys embed run                 # Generate/update embeddings
ctx-sys embed status              # Coverage report

# Summarization
ctx-sys summarize run             # Generate LLM summaries
ctx-sys summarize status          # Coverage report

# Sessions & memory
ctx-sys session list              # Conversation sessions
ctx-sys session messages [id]     # View session messages

# Knowledge bases
ctx-sys kb create           # Package as shareable .ctx-kb
ctx-sys kb install          # Install a knowledge base

# Debug
ctx-sys debug health              # System health check
ctx-sys debug inspect             # Database tables
ctx-sys debug export        # Export project data

MCP工具

当作为MCP服务器连接时,ctx-sys公开了12个基于动作的工具:

工具 动作 它的作用
上下文查询 (独立) 具有源属性的混合RAG检索
实体 添加、获取、搜索、删除 管理代码和文档实体
索引 代码库、文档、同步、状态 解析和索引代码和文档
图 链接、查询、统计 导航实体关系
会话 创建、列出、存档、总结 会话生命周期
消息 存储、历史记录 会话间的对话消息
决定 搜索、创建 架构决策跟踪
检查点 保存、加载、列出、删除 代理状态持久化
记忆 溢出、召回、状态 热/冷内存层管理
反思 存储、查询 跨会话学习和课程
项目 创建、列出、设置活动、删除 多项目管理
钩子 install,impact report Git钩子集成

配置

项目配置(.ctx-sys/config.yaml)```yaml

project:
name: my-project

indexing:
ignore:
- node_modules
- dist
- .git

embeddings:
provider: ollama
model: mxbai-embed-large:latest

summarization:
provider: ollama
model: qwen3:0.6b

hyde:
model: gemma3:12b


### 全局配置(`~/.ctx-sys/config.yaml`)```yaml
database:
path: ~/.ctx-sys/ctx-sys.db

providers:
ollama:
base_url: http://localhost:11434
openai:
api_key: ${OPENAI_API_KEY}  # Optional cloud fallback

支持的语言

语言 解析 提取实体
types/JavaScript 树形图 函数、类、方法、接口、类型、导入
Python 树形图 函数、类、方法、导入
Rust 树保姆 函数、结构、impls、特征、导入
Go 树保姆 函数、结构、方法、接口、导入
Java 树形图 类、方法、接口、导入
C/C++ 树形图 函数、类、结构、枚举、命名空间、#includes
C# 树形图 类、接口、结构、记录、枚举、方法、用法

文档(Markdown、HTML、YAML、JSON、TOML、PDF、CSV、XML、纯文本)也使用语义分块进行索引。

需求

  • Node.js 18+
  • 奥拉玛 (用于局部嵌入和汇总)
  • mxbai-embed-large:latest --嵌入模型(1024维,自动检测)
  • qwen3:0.6b --摘要(可选)
  • gemma3:12b --HyDE查询扩展(可选)

建筑

ctx-sys将所有内容存储在一个SQLite数据库中,其中包含:

  • 实体 --代码符号、文档部分、对话消息
  • 关系 --包含、导入、调用、扩展、实现(从AST自动提取)
  • 矢量 --通过sqlite-vec嵌入实现快速KNN搜索
  • FTS5 --BM25排名的全文搜索
  • 会话 --具有决策跟踪功能的对话历史记录

搜索使用倒排融合将所有四种检索策略(向量、FTS、图、启发式重新排序)结合起来。高级功能包括HyDE查询扩展、查询分解、检索门控和智能上下文扩展。

从源头构建```bash

git clone https://github.com/davidfranz/ctx-sys.git
cd ctx-sys
npm install
npm run build
npm link # Makes ctx-sys available globally
```

贡献

欢迎捐款。看 白皮书 有关架构细节和 网站 获取完整文档。

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Ctx Sys 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ctx Sys 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ctx Sys 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ctx Sys 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Ctx Sys 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ctx Sys 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 TypeScript、Claude、编程辅助。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。