mcpbeat Sign in

Selvedge MCP Server

by masondelan Your server? Claim it
local only

Selvedge runs on your own machine — the client starts it, so there is no endpoint to ping. 223 installs a week from pypi. Last commit 15 Sep 2026.

Decision provenance for AI-coded codebases: the why, and what was already tried and rejected.

Installs per day peak 322 · avg 44 · -64% w/w
a month agotoday
223
Installs / week
pypi · selvedge
23
Stars
2 open issues
15 Sep 2026
Last commit
0 releases in 90 days
MIT
License
Python

What the code does

We read the source, 12 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command npm/bin/selvedge-mcp.js:113
  const child = spawn(cmd, args, { stdio: "inherit", shell: needsShell });
Builds a file path from a variable npm/bin/selvedge-mcp.js:85
      const candidate = path.join(dir, cmd + ext.toLowerCase());
        result = subprocess.run(

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add selvedge -- uvx selvedge
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "selvedge": {
      "args": [
        "selvedge"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.selvedge]
command = "uvx"
args = ["selvedge"]
.cursor/mcp.json
{
  "mcpServers": {
    "selvedge": {
      "args": [
        "selvedge"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "selvedge": {
      "args": [
        "selvedge"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: SELVEDGE_DB (Override the SQLite path. Defaults to .selvedge/selvedge.db next to the codebase.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Selvedge

same job, measured the same way
Lema MCP
by lemahq

Cited 'why was this decided?' answers for your repo and for React, Kubernetes, and Rust.

56 installs/wk local only
Hypermnesia MCP Viz
by cdeust

Read-only visualization for Cortex memory, knowledge, sessions, traces, and codebase graphs.

95 installs/wk local only
Aifp
by aryanduntley

Database-driven FP enforcement and project management for AI-maintained codebases

7 installs/wk local only
Shipyard
by goshipyard

Ship, discover and review vibe-coded projects on Shipyard, the invite-only feed for AI-built apps.

9 tools answering
I
logbook-mcp
by abduljabbarbxr

Project memory across sessions for AI agents. A queryable decision log in the repo.

599 installs/wk local only
Safe Fix MCP
by pamela-0

Finds real dead code and proposes a safe, test-gated branch+PR to remove it.

99 installs/wk local only
Repomix
by yamadashy

Pack local or remote codebases into AI-friendly files that LLMs and coding agents can read or search

66 962 installs/wk local only
Relay MCP
by zhowe-designs

Self-hosted session relay. Shared threads across Claude Code, Cowork, and Claude.ai.

local only

Selvedge — questions

Answers built from our own checks of this server.

Why is there no uptime for Selvedge?
Selvedge runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package selvedge was installed 223 times last week.
How do I connect Selvedge?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls selvedge straight from pypi; nothing to host, nothing to sign up for.
How many people use Selvedge?
The pypi package selvedge was installed 223 times in the last week. Week over week that is -64%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Selvedge open source?
Yes — it is published under the MIT licence, written in Python, 23 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.