seraph-mcp

# Seraph Local code search and Git-aware code intelligence for coding agents. Seraph indexes a local Git checkout into a SQLite database and exposes working-tree search, change impact, task context, repository maps, symbols, dependencies, history, and version comparison over MCP. Source parsing covers Python, JavaScript, TypeScript, Go, C, C++, Java, C#, Rust, PHP, Ruby, Swift, Kotlin, Bash, Dart, Lua, SQL, Fortran, and Scala. ## Install from a checkout Requires Python 3.12 and Git. With `uv`: ```sh uv tool install --from . seraph-mcp ``` For development directly from this directory: ```sh uv sync uv run seraph-mcp ``` Install the published package from PyPI: ```sh python -m pip install seraph-mcp ``` ## Agent setup Register a local **stdio MCP server** in your agent with command `seraph-mcp` and no arguments, then reload the MCP connection. Use your agent's own MCP setup UI or command because configuration differs by host. On every Seraph tool call, pass `repo` as the absolute path to the local Git checkout you want searched. Use the active workspace path for that project, or a different repository path when the question is about another checkout. Seraph runs on the user's machine. Each tool accepts `repo`, the absolute path to the local Git checkout to search. The agent should pass the active workspace path on every call; if asked about another checkout, pass that checkout's path. The index is stored at `<repo>/.seraph/index.sqlite` and ignored by Git. ## MCP tools - `search_code`: retrieve relevant code from the selected checkout. - `search_at_version`: retrieve code from a commit, branch, or tag. - `search_history`: search indexed Git versions. - `find_symbol`: locate a function, class, or method. - `find_dependencies`: walk call, import, and inheritance relationships. - `get_working_tree_status`: see staged, unstaged, and untracked source changes. - `search_worktree`: search current on-disk source, including uncommitted edits and untracked files. …