open-index/open-npm huggingface dataset:
npm package: @jsonresume/jsonresume-mcp
Description: ModelContextProtocol starter server
Latest version: 0.2.0

# JsonResume MCP Tool

A [ModelContextProtocol](https://modelcontextprotocol.io) server for automatically updating a [JsonResume](https://jsonresume.org) 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:

```json
{
  "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

## 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