Log inSubmit server
Interviewer MCP logo

Interviewer MCP

Repo-based interview prep with code teaching, mock questioning, job-description targeting, and persistent weakness tracking.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Interviewer MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "interviewer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "interviewer-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "YOUR_VALUE_HERE",
        "INTERVIEWER_DATA_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The interviewer-mcp MCP server indexes GitHub repositories into teachable code sections and uses them for technical interview preparation. Its tools expose repository ingestion, ordered section review, code retrieval, coverage tracking, interview targeting, answer scoring, job-description storage, and progress history. Data is stored locally, while GitHub is the only external service described for network access. Reach for it when candidates need to explain their own code and revisit weak areas across sessions.

Use cases

  • Prepare to explain a portfolio repository in a technical interview
  • Review weak sections from previous mock interviews
  • Map a job description and CV to evidence in a codebase
  • Practice questions about authentication, APIs, SQL, and concurrency in your code

Key features

  • GitHub repository ingestion and code mapping
  • Ordered code teaching sections
  • Weakness and coverage tracking
  • Code-grounded mock interview targets
  • Job-description and CV targeting
  • Persistent local interview history

Tools8

What Interviewer MCP lets your agent do. Expand a tool for its parameters.

Self-reported~136 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · interviewer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads135Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed8Callable tools this server registers over MCP.

How Interviewer MCP works

What interviewer-mcp MCP server does

The interviewer-mcp MCP server turns a GitHub repository into a structured interview curriculum. It fetches repository content through the GitHub REST API, filters for source files, divides code into sections, and orders those sections from entry points through commonly imported logic and utilities. The resulting map supports both guided teaching and questions grounded in the candidate's actual code.

The workflow covers five related activities: company briefing, concept bootcamp, code deep-dives, mock interviews, and debriefs. A stored job description, company, and CV can connect repository sections to expected skills and highlight areas the codebase does not demonstrate. This makes the interviewer-mcp MCP server a fit for project-focused technical preparation rather than algorithm practice or general behavioral coaching.

How it works

The interviewer-mcp MCP server exposes eight MCP tools. ingest_repo creates the code map; list_sections reports the teaching order, coverage state, and weakness scores; and get_code_section returns a selected section with file context. A section is marked complete with mark_covered only after the candidate explains it back.

For interview practice, get_interview_targets identifies code worth probing and puts weaker areas first. log_interview_result records whether an answer was strong, okay, or weak, along with a note. Strong answers reduce a section's weakness over time, while weak answers increase it. get_progress provides the returning-session view of coverage, history, and top weaknesses. set_job_description stores the job description, company, and CV for briefing, bootcamp, and gap-question use.

Sectioning is regex-based for JavaScript and TypeScript, Python, Go, Java, C#, and Kotlin, with chunking as a fallback. Exact AST-based boundaries are not part of the current implementation.

Setup and configuration

The MCP path runs with Node.js 20 or newer and can be started through npx:

Terminal
claude mcp add interviewer -- npx -y interviewer-mcp

A GitHub token can be supplied for private repositories and a higher GitHub API limit:

Terminal
claude mcp add interviewer --env GITHUB_TOKEN=github_pat_... -- npx -y interviewer-mcp

GitHub classic and fine-grained tokens are supported; the documented permission is read-only Contents access. Without a token, the server can use the lower unauthenticated request limit described by the project.

The local data directory defaults to ~/.interviewer-mcp/. Set INTERVIEWER_DATA_DIR to change its location. The local store contains the code cache and interview history.

Tools and capabilities

  • Ingest a GitHub repository without cloning it locally.
  • Present source code in ordered, teachable sections.
  • Track which sections were explained and identify weak spots.
  • Generate interview targets from code patterns such as API calls, authentication handling, raw SQL, concurrency, TODOs, and long uncommented functions.
  • Associate preparation with a job description, company, and CV.
  • Preserve scored interview answers for later sessions.

The tools are intended to be directed by an MCP client or agent. The server supplies repository context and persistence; the interview dialogue itself is conducted through the connected agent.

Limitations and notes

This project is aimed at explaining and defending project code. It is not presented as a DSA drilling tool, and the README advises skipping it for generic behavioral preparation without a codebase. Repository analysis currently uses language-family regexes and fallback chunking rather than tree-sitter parsing. Multi-repository interviews and spaced-repetition scheduling are listed as roadmap items, not current capabilities.

A Claude Skill is also documented as a separate, no-install option for claude.ai. That route clones the repository per session and relies on conversation search for prior-session recall; the durable local database and persistent coverage model described here belong to the MCP server path.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Interviewer MCP

interviewer-mcp is an MCP server that connects an AI agent to GitHub repositories and a local interview-progress store. Its main tools ingest repositories, retrieve teachable code sections, track coverage, identify weak interview targets, score answers, store job details, and report progress across sessions.

Install it with `npx` through an MCP client, such as Claude Code: `claude mcp add interviewer -- npx -y interviewer-mcp`. Claude Desktop uses an MCP server configuration with `npx` as the command and `-y interviewer-mcp` as arguments.

Yes, private repositories are supported when you provide `GITHUB_TOKEN`.

It stores the code cache and interview history locally in `~/.interviewer-mcp/` by default.

Related MCP servers

All in Education All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInterviewer MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/interviewer-mcp?style=directory)](https://allmcps.com/mcp/interviewer-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/interviewer-mcp"><img src="https://allmcps.com/api/badge/interviewer-mcp?style=directory" alt="Interviewer MCP on AllMCPs" /></a>