使用说明

项目简介

JSON Resume MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，旨在通过AI技术自动化您的 JSON Resume 更新流程。它能够分析您的代码仓库，提取项目信息和技术技能，并智能地更新您的 JSON Resume，从而帮助您更高效地维护和优化您的技术简历。

主要功能点

简历增强：自动分析您的代码仓库，并将项目详情添加到您的 JSON Resume 中。
GitHub 集成：支持从 GitHub Gist 获取和更新您的 JSON Resume。
AI 驱动：利用 OpenAI 生成专业的项目和技能描述。
JSON Resume 生态：完全兼容 JSON Resume 标准及其生态系统。

安装步骤

环境准备
- 确保您拥有 GitHub 账号和个人访问令牌（需要 'gist' 权限）。
- 确保您已申请 OpenAI API 密钥。
- 确保已安装 Node.js 18 或更高版本。
- 建议使用支持 MCP 的 IDE，例如 Windsurf 或 Cursor。

安装 MCP Server 您可以通过 npm 全局安装 JSON Resume MCP Server：

npm install -g @jsonresume/mcp

服务器配置

MCP 服务器需要配置在 MCP 客户端（如 Windsurf 或 Cursor）中。以下是在 Windsurf 或 Cursor 中配置 JSON Resume MCP Server 的方法。您需要提供 GitHub 令牌、GitHub 用户名和 OpenAI API 密钥作为环境变量。

Windsurf 配置：

打开 Windsurf 设置 -> MCP Servers，添加以下配置：

{
  "jsonresume": {
    "command": "npx",
    "args": ["-y", "@jsonresume/mcp"],
    "env": {
      "GITHUB_TOKEN": "您的GitHub个人访问令牌",
      "OPENAI_API_KEY": "您的OpenAI API密钥",
      "GITHUB_USERNAME": "您的GitHub用户名"
    }
  }
}

Cursor 配置：

编辑 '~/.cursor/mcp_config.json' 文件，添加以下配置：

{
  "mcpServers": {
    "jsonresume": {
      "command": "npx",
      "args": ["-y", "@jsonresume/mcp"],
      "env": {
        "GITHUB_TOKEN": "您的GitHub个人访问令牌",
        "OPENAI_API_KEY": "您的OpenAI API密钥",
        "GITHUB_USERNAME": "您的GitHub用户名"
      }
    }
  }
}

配置参数说明：

'server name'：'jsonresume'，服务器名称，客户端用此名称来标识和调用该MCP服务器。
'command'：'npx'，运行命令，用于启动 MCP 服务器。
'args'：'["-y", "@jsonresume/mcp"]'，命令参数，'-y' 表示自动确认安装 '@jsonresume/mcp' 包，'@jsonresume/mcp' 是要执行的 npm 包。
'env'：环境变量配置，包含以下键值对：
- 'GITHUB_TOKEN'：您的 GitHub 个人访问令牌，用于访问 GitHub API 和 Gist。
- 'OPENAI_API_KEY'：您的 OpenAI API 密钥，用于使用 OpenAI 的 AI 功能。
- 'GITHUB_USERNAME'：您的 GitHub 用户名，用于定位您的 GitHub 账户。

基本使用方法

配置完成后，您可以在支持 MCP 的 AI 助手中使用以下命令来操作您的 JSON Resume：

增强简历：询问 AI 助手类似 “Can you enhance my resume with details from my current project?” 的问题，助手会自动分析当前项目代码，并更新您的 JSON Resume。
检查简历状态：询问 AI 助手类似 “Can you check if I have a JSON Resume?” 的问题，助手会检查您是否已存在 JSON Resume 并显示其信息。
分析代码库：询问 AI 助手类似 “What technologies am I using in this project?” 的问题，助手会分析您的代码库，并提供关于技术、语言和最近提交的信息。

注意： 首次使用可能需要等待服务器启动和初始化。请确保您的 GitHub 令牌和 OpenAI API 密钥配置正确。

关键词