@jsonresume/jsonresume-mcp

JsonResume MCP Tool

A ModelContextProtocol server for automatically updating a JsonResume based on GitHub activity. This tool enables AI assistants like Claude or Windsurf to update your resume by analyzing your coding activities.

Features

• Automatically fetches your resume from GitHub gists
• Creates a sample resume if none exists
• Analyzes your GitHub repositories and contributions
• Uses OpenAI to generate relevant resume updates
• Pushes the updated resume back to GitHub
• Integrates with the JsonResume ecosystem (registry.jsonresume.org)

Setup

Prerequisites

You'll need:

• GitHub account with a personal access token (with gist permissions)
• OpenAI API key
• Node.js installed

Installation

• Clone this repository:

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

• Install dependencies and build:

npm install
npm run build

• Configure environment variables. You need to set:
  • GITHUB_TOKEN: Your GitHub personal access token
  • OPENAI_API_KEY: Your OpenAI API key
  • GITHUB_USERNAME: Your GitHub username

Configure with Windsurf/Cursor

To use this tool with Windsurf or Cursor, add the following to your configuration:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@jsonresume/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 ask your AI assistant to "update my resume" and it will:

• Find your resume on GitHub (or create a new one if it doesn't exist)
• Analyze your GitHub repositories and contributions
• Generate relevant updates for your resume
• Push the changes back to GitHub
• Provide a link to your updated resume on registry.jsonresume.org

Development

To run the server in development mode:

npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT