Streamline Your Resume with JSON Resume MCP Server

text: AI code: AI

Tired of manually updating your resume every time you finish a new project? The JSON Resume MCP Server is here to help. This tool automatically updates your JSON Resume by analyzing your code and adding your latest project details.

What It Does

• Resume Update:
  It checks for an existing resume on GitHub Gists and updates it, or creates a new one if needed.
• Code Analysis:
  It goes through your codebase to pick out relevant skills and project highlights.
• AI-Powered Descriptions:
  By using OpenAI, it generates professional and concise descriptions of your work.
• Validation:
  Built with TypeScript and Zod, it ensures your resume meets the JSON Resume standard.

Getting Started

Prerequisites

• A GitHub account with a personal access token (make sure it has gist permissions).
• An OpenAI API key.
• Node.js version 18 or higher.
• An IDE that supports MCP servers like Windsurf or Cursor.

Installation

Install the MCP server globally using npm:

npm install -g @jsonresume/mcp
    

Configuration

For Windsurf:

Add the following to your Windsurf settings:

{
      "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"
        }
      }
    }
    

Learn more about Windsurf configuration.

For Cursor:

Add this 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"
          }
        }
      }
    }
    

For additional details, check out the Cursor documentation.

How It Works

Once set up, you simply ask your AI assistant something like:

“Can you enhance my resume with details from my current project?”

The MCP server will then:

• Find or create your JSON Resume on GitHub Gists.
• Analyze your code to extract project details and skills.
• Generate a neat project description with OpenAI.
• Update your resume automatically.

Contributing and Testing

Interested in improving the tool? Check out the GitHub repository for:

• Test Scripts: Run tests like npx tsx tests/check-openai.ts or node tests/test-mcp.js found in the tests directory.
• Contribution Guidelines: See the CONTRIBUTING.md for details on how to get started.

License

This project is licensed under the MIT License. For complete details, refer to the LICENSE file.

The JSON Resume MCP Server is a practical tool for developers who want to keep their resumes current without the hassle. For more information and to join the community, visit the JSON Resume MCP Server GitHub repository.

Happy coding!