JSON Resume MCP Server

JSON Resume Logo

Automate your resume updates with AI by analyzing your coding projects

Installation • Features • Usage • Configuration • Contributing • Testing

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:

Check if you have an existing JSON Resume
Analyze your codebase to understand your technical skills and projects
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)

Installing via Smithery

To install mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jsonresume/mcp --client claude

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:

Find your existing resume on GitHub (or create a new one if needed)
Analyze your current project's codebase
Generate professional descriptions of your project and skills
Update your resume with the new information
Save the changes back to GitHub
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 codebase and provide insights about languages, technologies, and recent commits.

Configuration

The MCP server requires the following environment variables:

Variable	Description
`GITHUB_TOKEN`	Your GitHub personal access token with gist permissions
`GITHUB_USERNAME`	Your GitHub username
`OPENAI_API_KEY`	Your OpenAI API key

Development

To run the server in development mode:

Clone the repository:

git clone https://github.com/jsonresume/mcp.git
cd mcp

Install dependencies:

npm install

Run in development mode:

npm run dev

This starts the MCP server with the inspector tool for debugging.

Contributing

Contributions are welcome! Here's how you can contribute:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add some amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Please ensure your code follows the existing style and includes appropriate tests.

Testing

The MCP server includes several test scripts to help debug and verify functionality.

Running Tests

All test scripts are located in the tests/ directory.

Before running tests, set your environment variables:

export GITHUB_TOKEN=your_github_token
export OPENAI_API_KEY=your_openai_api_key
export GITHUB_USERNAME=your_github_username

Check OpenAI API Key

Validates that your OpenAI API key is working correctly:

npx tsx tests/check-openai.ts

Mock Resume Enhancement

Tests the resume enhancement functionality using mock data (no API calls):

npx tsx tests/debug-mock.ts

Full Resume Enhancement Test

Tests the complete resume enhancement process with live API calls:

npx tsx tests/debug-enhance.ts

MCP Protocol Test

Tests the MCP server protocol communication:

node tests/test-mcp.js

Adding to package.json

For convenience, you can add these test commands to your package.json:

"scripts": {
  "test:openai": "tsx tests/check-openai.ts",
  "test:mock": "tsx tests/debug-mock.ts",
  "test:enhance": "tsx tests/debug-enhance.ts",
  "test:mcp": "node tests/test-mcp.js"
}

Then run them with npm run test:mock, etc.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

JSON Resume for the resume standard
Model Context Protocol for enabling AI tool integration
OpenAI for powering the AI resume enhancements

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

A server that enhances AI assistants with the ability to update your JSON Resume by analyzing your coding projects, automatically extracting skills and generating professional descriptions.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Calc Tools
nbiish
A
security
F
license
A
quality
A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
Last updated -
18
1
JavaScript
Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
40
MIT License
PapersWithCode MCP
hbg
-
security
A
license
-
quality
A server that allows AI assistants to search for research papers, read their content, and access related code repositories through the PapersWithCode API.
Last updated -
9
Python
MIT License
MCP Server
tcpipuk
-
security
A
license
-
quality
A server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.
Last updated -
2
Python
GPL 3.0

View all related MCP servers

JSON Resume MCP Server