MCP.so
Sign In

Selvedge

@masondelan

Repository

About Selvedge

Selvedge is a local, open-source MCP server that captures the *why* behind every change AI coding agents make — live, in the moment, from the agent's own context (not inferred later by a second LLM). It logs the entity (DB column, table, function, route, env var, dependency), the

#mcp-server#ai-tools#claude-code#cursor#developer-tools#code-tracking#change-tracking#audit-log#agent-memory#sqlite#python#observability

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "selvedge": {
      "command": "uvx",
      "args": [
        "--from",
        "selvedge",
        "selvedge-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Selvedge?

Selvedge is a long-term memory system for AI-coded codebases that captures the reasoning behind code changes as they are made by AI agents. It stores why a change was made, not just what changed, using an MCP server that agents call during development.

How to use Selvedge?

Install via pip install selvedge, run selvedge init once, and add configuration lines to your CLAUDE.md. Use commands like selvedge blame <entity> to see the history and reasoning behind any code change.

Key features of Selvedge

  • Captures agent reasoning live during code changes, not inferred post-hoc
  • Entity-level attribution for database columns, tables, env vars, APIs, functions
  • Changeset grouping across multiple entities for complex feature rollouts
  • SQLite storage with zero external dependencies
  • Concurrent write support with retry logic and WAL mode
  • CLI commands: blame, status, diff, search, history, import

Use cases of Selvedge

  • Debugging schema decisions months after the AI agent session has ended
  • Understanding why a specific database column or API endpoint was added
  • Auditing dependency changes across long-running AI-coded projects
  • Solo developers tracking reasoning across weekend builds and side projects
  • Pulling up the full scope of a billing migration that touched multiple files

FAQ from Selvedge

How does Selvedge differ from git blame?

Git blame tells you what changed and when. Selvedge captures why the change was made, with reasoning written by the AI agent from the same context that produced the change.

What are the dependencies and runtime requirements?

Selvedge uses SQLite for storage with zero external dependencies. Install via pip.

Where does Selvedge store data?

In a SQLite file under .selvedge/ in your project directory, or globally at ~/.selvedge/selvedge.db.

What transports and authentication does Selvedge use?

Selvedge communicates via MCP protocol over JSON-RPC stdio transport.

How does reasoning capture work?

Reasoning is captured live by the AI agent during the change, written from the same context window that produced the modification. This contrasts with tools that infer reasoning post-hoc from the diff.

Frequently asked questions

How does Selvedge differ from git blame?

Git blame tells you what changed and when. Selvedge captures why the change was made, with reasoning written by the AI agent from the same context that produced the change.

What are the dependencies and runtime requirements?

Selvedge uses SQLite for storage with zero external dependencies. Install via pip.

Where does Selvedge store data?

In a SQLite file under `.selvedge/` in your project directory, or globally at `~/.selvedge/selvedge.db`.

What transports and authentication does Selvedge use?

Selvedge communicates via MCP protocol over JSON-RPC stdio transport.

How does reasoning capture work?

Reasoning is captured live by the AI agent during the change, written from the same context window that produced the modification. This contrasts with tools that infer reasoning post-hoc from the diff.

Comments

Basic information

Category

AI & Agents

Transports

stdio

Author

masondelan

Submitted by

Mason Delan

More AI & Agents MCP servers

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797

mcp-hfspace MCP Server 🤗

evalstate

MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.

387

Perplexity Ask MCP Server

ppl-ai

The official MCP server implementation for the Perplexity API Platform

2.4K

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD