Skip to main content
Glama
Mortau

SourceRecall MCP Server

by Mortau

SourceRecall

SourceRecall 是一个自托管的仓库智能服务,专为 AI 编码助手设计。它将干净的 Git 工作树索引到 Qdrant 中,结合语义和词汇检索,通过独立的 Jetson NLP 服务对候选结果进行重排序,并通过 HTTP 和模型上下文协议(MCP)暴露结果。

该服务专为小型可信网络部署而设计,仓库数据必须保持在操作者的控制之下。

亮点

  • 安全仓库隔离,统一管理根目录

  • 基于干净提交的索引,包含文件、块、模型和模式溯源

  • 权威性全量重建索引,移除过时的 Qdrant 点

  • 混合向量与 ripgrep 检索,结合块感知的倒数排位融合

  • 通过 Jetson NLP 提供可选交叉编码器重排序

  • 精简的流式 HTTP MCP 集成,支持结构化工具响应

  • 持久化 SQLite 任务与索引状态

  • 经过验证的 YAML 配置与结构化轮转日志文件

  • 单工作线程、序列化索引模型,具有明确资源限制

Related MCP server: Qurio MCP Server

架构

Continue Agent
    |
    | Streamable HTTP MCP
    v
SourceRecall MCP :8071
    |
    v
SourceRecall API :8070
    |                 |
    |                 +--> managed Git repositories
    |                      + ripgrep lexical retrieval
    |
    +--> Qdrant :6333
    +--> Jetson NLP :8091 (/v1/embeddings and /v1/rerank)

SourceRecall 负责仓库、路径、提交、块和检索语义。Jetson NLP 仍然是一个无状态推理服务,仅处理文本、向量和分数。

仓库布局

config/             Versioned configuration template
deploy/systemd/     API and MCP systemd units
diags/              Deployment validation utilities
docs/               Architecture, API, deployment, and operations guides
src/source_recall/  Installable Python package
tests/              Automated tests

API 概览

curl http://source-recall:8070/live

curl -X POST http://source-recall:8070/index \
  -H 'Content-Type: application/json' \
  -d '{"repository":"episode-tracker"}'

curl -X POST http://source-recall:8070/search \
  -H 'Content-Type: application/json' \
  -d '{
    "repository":"episode-tracker",
    "query":"where are TV episode credits normalized?",
    "limit":8
  }'

当配置了 security.api_token 时,请在所有非健康检查的 API 请求中添加 Authorization: Bearer <token>。

生产路径

用途

路径

应用程序

/opt/source-recall

虚拟环境

/opt/source-recall/.venv

配置文件

/etc/source-recall/source-recall.yaml

受管仓库

/opt/source-recall/repositories

持久化状态

/var/lib/source-recall/source-recall.db

应用日志

/var/log/source-recall/source-recall.log

API 服务

/etc/systemd/system/source-recall-api.service

MCP 服务

/etc/systemd/system/source-recall-mcp.service

完整安装流程请参见 部署。

文档

当前范围

初始版本执行权威性全量索引。增量 Git 索引、Webhook 接入、语法感知分块、符号图及引用分析属于计划中的扩展功能,而非当前声称的特性。索引任务具有持久化状态报告能力,但在单个本地进程中执行;这不是一个分布式任务队列。

服务不终止 TLS,MCP 端点也不实现客户端认证。请将其部署在可信的私有网络中,或置于经过认证的反向代理之后。参见 安全。

许可证

SourceRecall 采用 MIT 许可证。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides AI-powered semantic code search across multiple repositories, allowing natural language queries to find code chunks and retrieve specific file contents through Dolphin AI embeddings.
    4 npm
    2
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding assistants to search and retrieve information from a locally ingested knowledge base using hybrid search, grounded in user-curated documentation.
    17
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to perform intelligent semantic code search across codebases using local AI embeddings for meaning-based retrieval.
    6
    31 npm
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents and IDEs to ingest and search code repositories using hybrid retrieval (dense + sparse) with exact line-level citations for precise code analysis.
    1
    -