Delphi Code

io.github.markdorof由 GitHub 账号 markdorof 发布v0.3.4更新于 Nov 1, 2026

Let coding agents browse code across all your local, GitHub and Bitbucket repos, offline

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

本地 MCP 服务器，为本地、GitHub 与 Bitbucket 仓库建立索引，让编码助手离线按语义搜索代码。

可以做什么
  • 用自然语言查询一次搜索所有已索引仓库，可按语言、路径或结果数量过滤。
  • 跟踪并索引本地路径或远程 GitHub、Bitbucket 仓库，可指定分支或标签，并只对变更内容重新同步。
  • 列出已跟踪项目、查看某个项目的索引、停止跟踪某个项目。
  • 打开本地网页界面进行搜索、管理项目和检查安装，并对模型与存储做诊断。
适用场景
适合编码助手需要跨多个仓库定位相关文件、且文件中并不包含问题原词的情况，也适合要求代码不离开本机、不依赖云服务的场景。
运行要求
以本地 stdio 进程运行，通过 uvx 或 uv 工具安装；需 macOS 14 及以上、Apple 芯片（Linux 未测试，不支持 Windows）。初始化时需联网下载一次本地嵌入模型。访问私有远程仓库可选提供 GITHUB_TOKEN 或 GH_TOKEN，以及 BITBUCKET_APP_PASSWORD 配合 BITBUCKET_EMAIL 或 BITBUCKET_USERNAME。仅 setup、add 和 sync 会联网。
安装前请注意
安装脚本会下载并执行代码，可能安装 uv 并修改各助手的配置；connect 和 disconnect 会改动助手的配置文件。访问远程仓库需使用 GITHUB_TOKEN、GH_TOKEN、BITBUCKET_APP_PASSWORD 等令牌，这些令牌可访问你的仓库。索引与模型数据保存在本机，占用空间可能较大。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Delphi Code，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Delphi Code

Let your coding agent browse code across all your repositories. Index local projects and GitHub or Bitbucket repositories, then ask "where does the backend handle the refund the web app requests?" and get the right files from every repository at once, even when no file contains those words.

[Claude Code, opened in one service, is asked whether an endpoint can be removed and finds its only caller in another repository]

  • Private: your code never leaves your machine. Indexing and search run offline with a local model; no account, cloud provider, or background daemon.
  • Fast: the MCP server keeps the model loaded, so repeated searches are near-instant. No GPU needed.
  • Works with your agents: Claude Code, Claude Desktop, Codex, Cursor, VS Code, Gemini CLI, and OpenCode.

Install

sh
curl -LsSf https://github.com/markdorof/delphi-code/releases/latest/download/install.sh | sh

The script installs uv if needed, then runs setup, which downloads the embedding model once and connects every agent it finds. Options go after sh -s --: --no-setup, --no-connect, --version VERSION. With uv already installed:

sh
uv tool install --managed-python --python 3.14 delphi-codedelphi-code setup

Requires macOS 14+ on Apple silicon (Linux is untested, Windows unsupported). delphi-code doctor checks the installation.

Use

sh
delphi-code add ~/src/api github.com/octo/tools   # track and index projectsdelphi-code search 'where are user passwords checked?'delphi-code ui                                     # or do it all in the browser

Your agent calls the same search through MCP. After installing a new agent, run delphi-code connect. To connect one by hand:

AgentSetup
Claude Codeclaude plugin marketplace add markdorof/delphi-code, then claude plugin install delphi-code@delphi-code
Codexcodex plugin marketplace add markdorof/delphi-code, then codex plugin add delphi-code@delphi-code
CursorAdd {"mcpServers": {"delphi-code": {"type": "stdio", "command": "delphi-code", "args": ["mcp"]}}} to ~/.cursor/mcp.json
VS Code (Copilot)code --add-mcp '{"name": "delphi-code", "command": "delphi-code", "args": ["mcp"]}'
Gemini CLIgemini mcp add delphi-code delphi-code mcp
OpenCodeAdd {"mcp": {"delphi-code": {"type": "local", "command": ["delphi-code", "mcp"]}}} to ~/.config/opencode/opencode.json

For agents other than Claude Code and Codex, also copy the skill into the agent's skills folder so it knows when to search by meaning instead of grep.

Commands

CommandWhat it does
setupDownloads the model (or imports it with --from DIR on an offline machine) and connects agents.
add [SOURCE ...]Tracks and indexes local paths or remote repositories (--ref picks a branch or tag). Without sources, picks repositories from your GitHub or Bitbucket account.
sync [PROJECT ...]Updates tracked projects, re-embedding only what changed.
index -p PATHIndexes a project once without tracking it.
search QUERYSearches every index, or one with -p. Filter with --language, --path, --limit.
list, status, remove NAMEShow tracked projects, show a project's index, stop tracking a project.
connect, disconnectAdd or remove Delphi Code in your agents' configs.
uiOpens a local web UI for search, projects, and setup checks.
doctorChecks the model and storage.
mcpServes the commands as MCP tools over stdio.

-p takes a path or an indexed project's name. index and add skip .gitignored files and accept --ignore, --path, and --language. Every command takes --help, and most take --json for scripts. Only setup, add, and sync use the network.

Settings

VariablePurpose
GITHUB_TOKEN / GH_TOKENGitHub access for remote repositories (falls back to gh auth token, then git's credentials)
BITBUCKET_APP_PASSWORD with BITBUCKET_EMAIL or BITBUCKET_USERNAMEBitbucket access (an API token works)
DELPHI_CODE_MODELUse another local SentenceTransformers model instead of the default all-MiniLM-L6-v2
DELPHI_CODE_INDEX_ROOT, DELPHI_CODE_REGISTRY, DELPHI_CODE_LOG_FILEMove indexes, the tracked-project list, or the log
DELPHI_CODE_LOG_LEVELDEBUG, INFO, WARNING, ERROR, or OFF

Data lives in ~/Library/Application Support/delphi-code on macOS and ~/.local/share/delphi-code on Linux.

Upgrade and uninstall

sh
uv tool upgrade delphi-code

Your model and indexes are kept. If a command fails with index_incompatible, delete the index directory it names and run sync again. See releases for changes.

sh
delphi-code disconnectuv tool uninstall delphi-coderm -rf ~/Library/Application\ Support/delphi-codeuv cache clean   # frees about 900 MB of downloaded packages

If the install script installed uv and you don't need it, uninstall uv and its Python too.

License

Apache-2.0. See THIRD_PARTY_NOTICES.md. To contribute, see CONTRIBUTING.md.

来源：README.md，提交 fa3ce26

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

3
  1. v0.3.4最新Oct 18, 2026
  2. v0.3.3Oct 17, 2026
  3. v0.3.2Oct 17, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分