# stackhint

> stackhint is an open-source MCP server for developer tools. Local scanner that recommends MCP servers, plugins and skills for a repository. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://protemir.github.io/stackhint/
- **Repository:** https://github.com/protemir/stackhint
- **MCP Registry name:** io.github.Protemir/stackhint
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Instead of searching a directory by keyword, this server reads the project in front of it. It looks at manifests such as package.json, pyproject.toml, go.mod, Cargo.toml and *.csproj, plus compose files, Kubernetes and Terraform files, CI configuration, .env.example key names, README links and git history. Each recommendation points at the file that prompted it, and a passing remark in a README about maybe adopting Kubernetes someday does not trigger a suggestion.

It also reads existing Claude Code and Codex setup, including ~/.claude.json, .mcp.json, plugins, skills and ~/.codex/config.toml, so it does not recommend what is already installed. Its registry holds 143 hand-checked entries and includes retired ones; the command stackhint check flags them, for example telling you to replace the archived Postgres server.

Installs happen only after showing a diff, default to read-only modes, reference tokens by name and keep a backup with a stackhint rollback command. Everything runs locally with no dependencies and sends nothing anywhere. It needs Node.js 20 or newer and ships as a CLI, a plugin with hooks, or a read-only MCP server; Claude Desktop users install the .mcpb bundle and pass the project folder as the path.

## Features

- **Evidence-based picks:** Each suggestion names the file that triggered it.
- **Knows your setup:** Reads Claude Code and Codex configs to skip what you already have.
- **Hand-checked registry:** Covers 143 tools, including retired ones to replace.
- **Safe installs:** Shows a diff first, defaults to read-only, keeps a backup and offers rollback.
- **Runs locally:** No dependencies, and nothing is sent anywhere.
- **Several entry points:** Use it as a CLI, a Claude Code or Codex plugin, or an MCP server.

## Good for

- Find out which MCP servers fit a new repository
- Audit an existing setup for archived or retired servers
- Add a recommended server with a reviewable diff
- Get a quiet hint at session start in Claude Code
- Roll back a server install that went wrong

## Install

### Claude Code (Terminal)

```sh
claude mcp add stackhint -- npx -y https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "stackhint": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stackhint": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "stackhint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stackhint": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "stackhint": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb"
      ]
    }
  }
}
```

## FAQ

### What does it need to run?

Node.js 20 or newer and no other dependencies.

### Does it send my code anywhere?

The project says it runs locally and sends nothing anywhere.

### Which tools does it support?

Claude Code and Codex, plus Claude Desktop through an .mcpb bundle.

### Can it change my config?

Only after showing the exact change; it keeps a backup and has a rollback command.

### Is stackhint free?

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

### How do I add stackhint to Claude Code?

Run this command in your terminal: claude mcp add stackhint -- npx -y https://github.com/Protemir/stackhint/releases/download/v0.2.1/stackhint-0.2.1.mcpb

### What are the best alternatives to stackhint?

The closest alternatives to stackhint are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/stackhint
