Delphi Code

io.github.markdorofPublished by GitHub account markdorofv0.3.4Updated Nov 1, 2026

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

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Local MCP server that indexes your local, GitHub and Bitbucket repositories so a coding agent can search code by meaning, offline.

What you can do
  • Search all indexed repositories at once with natural-language queries, filtered by language, path or result limit.
  • Track and index local paths or remote GitHub and Bitbucket repositories, choosing a branch or tag, and re-sync only what changed.
  • List tracked projects, inspect a project's index, and stop tracking a project.
  • Open a local web UI for search, projects and setup checks, and run diagnostics on the model and storage.
When to use it
Useful when a coding agent needs to find relevant files across several repositories, including cases where no file contains the words of the question, and when code must stay on the machine with no cloud service involved.
Requirements
Runs as a local stdio process, installed with uvx or the uv tool installer; macOS 14+ on Apple silicon (Linux untested, Windows unsupported). Setup downloads a local embedding model once. Optional credentials for private remote repositories: GITHUB_TOKEN or GH_TOKEN, and BITBUCKET_APP_PASSWORD with BITBUCKET_EMAIL or BITBUCKET_USERNAME. Only setup, add and sync use the network.
Before you install
The install script downloads and runs code and may install uv and modify agent configurations; connect and disconnect edit your agents' config files. Remote repository access uses tokens such as GITHUB_TOKEN, GH_TOKEN and BITBUCKET_APP_PASSWORD, which grant access to your repositories. Indexes and model data are stored locally and can be large.

Installation

In SourceWeft

  1. Open Delphi Code in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: README.md at commit fa3ce26

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

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

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts