Repo Analyzer MCP Server (Local)

An MCP server that analyzes Git repositories and provides Dockerfile creation guidance. Runs locally using stdio transport.

Features

• Analyzes repository structure and dependencies
• Detects primary programming language
• Identifies exposed ports
• Handles monorepo detection
• Supports private GitHub repositories (with GITHUB_TOKEN)
• Provides detailed Dockerfile recommendations

Prerequisites

• Python >= 3.10
• Git command-line tool in PATH
• (Optional) GitHub Personal Access Token for private repos

Installation

1. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

1. Install dependencies:

pip install -e .

Usage

With MCP Inspector

mcp-inspector python src/repo_analyzer_mcp/server.py

With VS Code / GitHub Copilot

Add to VS Code settings (JSON) or create .vscode/mcp.json:

{
  "mcp.servers": {
    "repo-analyzer-local": {
      "type": "stdio",
      "command": "/path/to/venv/python",
      "args": ["/path/to/src/repo_analyzer_mcp/server.py"],
      "env": {
        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
      },
      "displayName": "Repo Analyzer (Local)"
    }
  }
}

Replace /path/to/ with actual paths on your system.

Environment Variables

• GITHUB_TOKEN: GitHub Personal Access Token (required for private repos)