JSON Resume MCP Server

<div align="center">

Automate your resume updates with AI by analyzing your coding projects

Installation • Features • Usage • Configuration • Contributing • Testing

</div>

What is JSON Resume MCP Server?

This is a Model Context Protocol (MCP) server that enhances AI assistants with the ability to update your JSON Resume by analyzing your coding projects. The MCP server provides tools that allow AI assistants like those in Windsurf or Cursor to:

1. Check if you have an existing JSON Resume
2. Analyze your codebase to understand your technical skills and projects
3. Enhance your resume with details about your current project

With this tool, you can simply ask your AI assistant to "enhance my resume with my current project," and it will automatically analyze your code, extract relevant skills and project details, and update your resume accordingly.

Video demo: https://x.com/ajaxdavis/status/1896953226282594381

Features

• Resume Enhancement: Automatically analyzes your codebase and adds project details to your resume
• GitHub Integration: Fetches and updates your resume stored in GitHub Gists
• AI-Powered: Uses OpenAI to generate professional descriptions of your projects and skills
• TypeScript/Zod Validation: Ensures your resume follows the JSON Resume standard
• JSON Resume Ecosystem: Compatible with the JSON Resume registry

Installation

Prerequisites

• GitHub account with a personal access token (with gist scope)
• OpenAI API key
• Node.js 18+
• An IDE with MCP support (Windsurf or Cursor)

Install via NPM

npm install -g @jsonresume/mcp

Install in Windsurf or Cursor

Add the following to your Windsurf or Cursor configuration:

Windsurf

Open Settings → MCP Servers and add:

{
  "jsonresume": {
    "command": "npx",
    "args": ["-y", "@jsonresume/mcp"],
    "env": {
      "GITHUB_TOKEN": "your-github-token",
      "OPENAI_API_KEY": "your-openai-api-key",
      "GITHUB_USERNAME": "your-github-username"
    }
  }
}

Cursor

Add to your ~/.cursor/mcp_config.json:

{
  "mcpServers": {
    "jsonresume": {
      "command": "npx",
      "args": ["-y", "@jsonresume/mcp"],
      "env": {
        "GITHUB_TOKEN": "your-github-token",
        "OPENAI_API_KEY": "your-openai-api-key",
        "GITHUB_USERNAME": "your-github-username"
      }
    }
  }
}

Usage

Once installed and configured, you can use the following commands with your AI assistant:

Enhance Your Resume with Current Project

Ask your AI assistant:

"Can you enhance my resume with details from my current project?"

The assistant will:

1. Find your existing resume on GitHub (or create a new one if needed)
2. Analyze your current project's codebase
3. Generate professional descriptions of your project and skills
4. Update your resume with the new information
5. Save the changes back to GitHub
6. Provide a link to view your updated resume

Check Your Resume Status

Ask your AI assistant:

"Can you check if I have a JSON Resume?"

The assistant will check if you have an existing resume and show its details.

Analyze Your Codebase

Ask your AI assistant:

"What technologies am I using in this project?"

The assistant will analyze your codeb