基本能力
产品定位
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 安装
bash
npx -y @smithery/cli install @jsonresume/mcp --client claude
通过 NPM 安装
bash
npm install -g @jsonresume/mcp
在 Windsurf 或 Cursor 中安装
Windsurf
在设置 → MCP Servers 中添加：
json
{
"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 中添加：
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"
}
}
}
}
调试方式
运行开发模式
bash
git clone https://github.com/jsonresume/mcp.git
cd mcp
npm install
npm run dev
运行测试脚本
bash
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
