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

1. Clone this repository:

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

2. Install dependencies and build:

npm install
npm run build

3. 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:

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

Changelog

v0.3.0

• Fixed bug where the tool created a new gist instead of updating the existing resume.json
• Added caching of gist IDs to improve performance and reliability
• Improved error handling and logging for better debugging
• Better preservation of internal metadata when updating resumes

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