# repo-pulse

> repo-pulse is an open-source MCP server for developer tools. Read-only git history insights for AI: review risk, hotspots, ownership and release notes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/hasanyelaldi/repo-pulse-mcp
- **MCP Registry name:** io.github.hasanyelaldi/repo-pulse-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Repo-pulse works on local git repositories only. It runs over stdio, needs Node.js 22.12 or newer plus git, never modifies a repository and never touches the network. Pull requests, issues and CI status are explicitly out of scope, so it works the same on clones from any host or on repos with no remote.

Its 13 tools are grouped by the question they answer. For review, `review_context` ranks the changed files of a branch by past churn and bug fixes, flags files that usually change together but were left out, and suggests reviewers. Ownership tools estimate who knows a path, the bus factor and files whose last author has left. Release and history tools draft notes between refs, list stale branches and search commits.

Beyond tools it exposes a repo overview resource and nine prompts such as review_branch, release_notes and catch_up. All tools carry readOnlyHint, declare an output schema and return structured content plus a JSON text block. Repositories are chosen with the REPO_PULSE_REPOS variable and toolsets can be narrowed with REPO_PULSE_TOOLS.

## Features

- **Branch review briefing:** Ranks changed files by churn and fixes, spots files left out of the change and suggests reviewers.
- **Bug hotspots:** Shows which files change most often and how many of those changes were fixes.
- **Change coupling:** Finds file pairs that keep changing in the same commits, revealing hidden dependencies.
- **Ownership and bus factor:** Weights recent work to show who knows a file or directory and which files depend on one person.
- **Release notes drafting:** Groups commits between two refs by conventional-commit type and outputs Markdown.
- **Built-in prompts:** Includes review_branch, release_notes, ownership_report, cleanup_branches and more.

## Good for

- Check a branch for risky files and forgotten tests before opening a pull request
- Find the files that keep breaking to plan refactoring
- Identify single-person knowledge risk in a module
- Draft release notes since the last tag
- List stale or already-merged branches to clean up

## Install

### Claude Code (Terminal)

```sh
claude mcp add repo-pulse-mcp --env REPO_PULSE_REPOS='<REPO_PULSE_REPOS>' -- npx -y repo-pulse-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "repo-pulse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "repo-pulse-mcp"
      ],
      "env": {
        "REPO_PULSE_REPOS": "<REPO_PULSE_REPOS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "repo-pulse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "repo-pulse-mcp"
      ],
      "env": {
        "REPO_PULSE_REPOS": "<REPO_PULSE_REPOS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "repo-pulse-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "repo-pulse-mcp"
      ],
      "env": {
        "REPO_PULSE_REPOS": "<REPO_PULSE_REPOS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "repo-pulse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "repo-pulse-mcp"
      ],
      "env": {
        "REPO_PULSE_REPOS": "<REPO_PULSE_REPOS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "repo-pulse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "repo-pulse-mcp"
      ],
      "env": {
        "REPO_PULSE_REPOS": "<REPO_PULSE_REPOS>"
      }
    }
  }
}
```

## Tools

- `review_context`: Briefing for a branch or PR with risky files, left-out files and reviewers.
- `file_hotspots`: Files ranked by change frequency and bug fixes.
- `change_coupling`: File pairs that change in the same commits.
- `knowledge_map`: Who knows a file or directory, bus factor and single-owner files.
- `code_age`: How long ago files last changed and oldest directories.
- `contributor_summary`: Commits per author in a time window.
- `release_notes_draft`: Commits between two refs grouped by type, with Markdown.
- `list_tags`: Tags newest first with unreleased count.
- `compare_refs`: Ahead/behind counts and commits between two refs.
- `stale_branches`: Branches with no recent commits and whether merged.
- `recent_activity`: Commits from the last N days.
- `commit_search`: Commits whose message matches text.
- `file_history`: A file's commits with line stats across renames.

## FAQ

### Does it change my repository?

No. It is read-only and all tools are annotated readOnlyHint true.

### Does it need network access or a GitHub token?

No. It reads local git data only and never uses the network.

### What are the requirements?

Node.js 22.12 or newer and git.

### Can I limit which tools are exposed?

Yes. Set REPO_PULSE_TOOLS to a list of toolsets (review, ownership, releases, history) or tool names.

### Is repo-pulse free?

Yes. repo-pulse is open source, so you can use and self-host it for free.

### How do I add repo-pulse to Claude Code?

Run this command in your terminal: claude mcp add repo-pulse-mcp --env REPO_PULSE_REPOS='<REPO_PULSE_REPOS>' -- npx -y repo-pulse-mcp

### What are the best alternatives to repo-pulse?

The closest alternatives to repo-pulse are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/repo-pulse
