JSON Resume MCP Server

基本能力

产品定位

JSON Resume MCP Server 是一个自动化简历更新工具，通过分析用户的代码库来增强 JSON Resume 的内容。

核心功能

• 简历增强：自动分析代码库并将项目细节添加到简历中。
• GitHub 集成：从 GitHub Gists 获取并更新简历。
• AI 支持：使用 OpenAI 生成项目的专业描述和技能。
• 类型验证：通过 TypeScript/Zod 确保简历符合 JSON Resume 标准。
• 生态系统兼容：与 JSON Resume 注册表兼容。

适用场景

• 开发者需要快速更新简历以反映当前项目。
• AI 助手需要自动化简历管理功能。
• 需要从代码库中提取技术技能和项目描述的场合。

工具列表

• GitHub 集成工具：用于从 GitHub Gists 获取和更新简历。
• OpenAI API 工具：用于生成项目描述和技能分析。
• JSON Resume 验证工具：确保简历格式符合标准。

常见问题解答

• 如何获取 GitHub Token？需要在 GitHub 上生成一个具有 Gist 权限的个人访问令牌。
• 如何配置 OpenAI API Key？需要在环境变量中设置 OPENAI_API_KEY。
• 如何调试？可以使用提供的测试脚本进行调试。

使用教程

使用依赖

• GitHub 账号及个人访问令牌（需具有 Gist 权限）。
• OpenAI API 密钥。
• Node.js 18+。
• 支持 MCP 的 IDE（如 Windsurf 或 Cursor）。

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @jsonresume/mcp --client claude

通过 NPM 安装

npm install -g @jsonresume/mcp

在 Windsurf 或 Cursor 中安装

Windsurf

在设置 → MCP Servers 中添加：

{
  "jsonresume": {
    "command": "npx",
    "args": ["-y", "@jsonresume/mcp"],
    "env": {
      "GITHUB_TOKEN": "your-github-token",
      "OPENAI_API_KEY": "your-openai-api-key",
      "GITHUB_USERNAME": "your-github-username"
    }
  }
}

Cursor

在 ~/.cursor/mcp_config.json 中添加：

{
  "mcpServers": {
    "jsonresume": {
      "command": "npx",
      "args": ["-y", "@jsonresume/mcp"],
      "env": {
        "GITHUB_TOKEN": "your-github-token",
        "OPENAI_API_KEY": "your-openai-api-key",
        "GITHUB_USERNAME": "your-github-username"
      }
    }
  }
}

调试方式

运行开发模式

git clone https://github.com/jsonresume/mcp.git
cd mcp
npm install
npm run dev

运行测试脚本

export GITHUB_TOKEN=your_github_token
export OPENAI_API_KEY=your_openai_api_key
export GITHUB_USERNAME=your_github_username
npx tsx tests/check-openai.ts
npx tsx tests/debug-mock.ts
npx tsx tests/debug-enhance.ts
node tests/test-mcp.js

许可证

该项目遵循 Unlicense 开源许可条款，请参阅 Unlicense 了解完整条款。