JSON Resume MCP Server

What is JSON Resume MCP Server?

JSON Resume MCP Server is a Model Context Protocol (MCP) server that enhances AI assistants (such as Windsurf and Cursor) with the ability to update a JSON Resume by analyzing coding projects. It fetches resumes stored in GitHub Gists, uses OpenAI to generate professional descriptions, and validates the resume against the JSON Resume standard.

How to use JSON Resume MCP Server?

Install globally via npm install -g @jsonresume/mcp or run with npx -y @jsonresume/mcp. Configure environment variables GITHUB_TOKEN, GITHUB_USERNAME, and OPENAI_API_KEY. Add the server to your IDE’s MCP configuration (for Windsurf or Cursor). Then ask your AI assistant commands like “enhance my resume with my current project” or “check if I have a JSON Resume”.

Key features of JSON Resume MCP Server

• Automatically analyzes codebase to update resume details.
• Integrates with GitHub Gists for resume storage and retrieval.
• Uses OpenAI to generate project descriptions and skill summaries.
• Validates resume structure with TypeScript and Zod.
• Compatible with the JSON Resume registry ecosystem.

Use cases of JSON Resume MCP Server

• Automatically enhance your resume with details from your current coding project.
• Check if you already have a JSON Resume and see its details.
• Analyze your codebase to get insights about languages, technologies, and recent commits.

FAQ from JSON Resume MCP Server

What are the prerequisites for using JSON Resume MCP Server?

You need a GitHub account with a personal access token (with gist scope), an OpenAI API key, Node.js 18+, and an MCP-supporting IDE (Windsurf or Cursor).

How do I install JSON Resume MCP Server?

Install via npm globally with npm install -g @jsonresume/mcp, or run it directly with npx -y @jsonresume/mcp. It can also be installed automatically via Smithery.

How do I configure JSON Resume MCP Server?

Set three environment variables: GITHUB_TOKEN (GitHub personal access token with gist permissions), GITHUB_USERNAME (your GitHub username), and OPENAI_API_KEY (your OpenAI API key). Provide these in your IDE’s MCP configuration file.

Where does my resume data live when using JSON Resume MCP Server?

Your resume is stored in a GitHub Gist associated with your GitHub account. The server fetches and updates that Gist.

What tools does JSON Resume MCP Server provide to AI assistants?

It provides three main tools: enhancing the resume with current project details, checking the existence and content of a resume, and analyzing the codebase for languages and technologies.