MCP职业指南
你的AI原生职业副驾驶，专为克劳德打造。
Career Compass将克劳德变成了一个完整的求职伙伴——一个了解你整个职业历史、量身定制每份简历和求职信、跟踪每份申请并为你准备每次面试的人。通过对话启动，车载，并在瞬间跟踪多个应用程序。
______________________________________________________________________
感觉如何
You: I have a panel interview at Veridian Health on Friday — Director of Operations role.
Can you prep me?
Claude: On it. Reading your career history now...
[Generates 90-second pitch, 8 STAR stories matched to likely panel questions,
company research brief, 10 questions to ask them, and a list of watch-outs
based on gaps in your background — all in one response]You: Here's a job posting I just found. [pastes posting]
How well do I fit?
Claude: Fit score: 8.1/10. Here's why — and here's what they'll probe you on...
[Returns matched strengths, honest gap analysis, talking points in their language,
and a "day in the life" of what the role actually looks like]You: Show me what needs attention in my pipeline today.
Claude: 3 things:
- Meridian Logistics follow-up is overdue (8 days since you applied, referral from Marcus Chen)
- Veridian panel is Friday — prep above
- Novare rejection arrived — want me to draft a keep-the-door-open response?______________________________________________________________________
建筑
┌─────────────┐ ┌──────────────────────────────────────┐
│ │ MCP │ MCP Server (Node.js) │
│ Claude │◄────────►│ │
│ │ stdio │ Tools ─── Resume, Pipeline, Interview│
│ │ │ Resources ─ Career KB, Pipeline data │
└─────────────┘ │ Prompts ── Power-user shortcuts │
│ │
│ ┌──────────────┐ │
│ │ File Store │ │
│ │ (YAML files) │ │
│ └──────┬───────┘ │
└────────────────┼─────────────────────┘
│ reads
┌────────────────┼─────────────────────┐
│ Dashboard │ (Next.js) │
│ ▼ │
│ Pipeline Kanban · Career KB Overview │
│ Analytics · Onboarding Wizard │
└──────────────────────────────────────┘______________________________________________________________________
仪表盘
v2.0提供了一个本地web仪表板——一个位于您的职业知识库和管道数据之上的可视化层。与Claude一起打开它或单独使用它来查看和管理您的搜索。
Pipeline Kanban Application Detail Career KB Analytics
四种观点：
管道看板 --按阶段列出的所有应用程序（探索→ 应用→ 筛查→ 面试→ 提供→ 关闭）。拖动以推进阶段。一目了然地查看过时的应用程序。单击任何卡片进行深入查看。
应用程序详细视图 --单个应用程序的完整时间线：每个状态更改、与角色相关的联系人、对话中的笔记和下一步操作。克劳德所知道的关于这个机会的一切都集中在一个地方。
职业知识库概述 --你的职业数据的视觉摘要：技能雷达（熟练度×新近度）、经验时间表、推荐信和一个完整性指标，显示克劳德必须使用的内容。有助于在你开始新角色之前发现差距。
分析 --漏斗转化率、来源响应率、阶段平均时间和来源有效性。看看哪些频道在实际工作。
打开仪表板：
career-compass-mcp dashboard______________________________________________________________________
快速开始
1.安装
npm install -g career-compass-mcp2.添加到克劳德
将此添加到您的 ~/.claude.json （克劳德代码）或等效的MCP配置：
{
"mcpServers": {
"career-compass": {
"command": "career-compass-mcp",
"env": {
"CAREER_DATA_PATH": "/Users/you/career-data"
}
}
}
}创建 career-data 您喜欢的任何目录——Career Compass将在第一次运行时初始化它。
3.打开仪表板
career-compass-mcp dashboard这将在浏览器中打开仪表板 http://localhost:3141 （或下一个可用端口）。使用它来完成入职培训，并直观地了解您的流程。
4.机上（第一次对话）
打开克劳德说：
“设置我的职业知识库。这是我的简历：” \[粘贴你的简历\]
克劳德将：
- 将你的工作经历、成就和技能提取到结构化的YAML中
- 就差距或不明确的指标提出澄清问题
- 将所有内容保存到您的
CAREER_DATA_PATH
然后打开仪表板以完成第二阶段：入职向导将引导您设定工作目标、薪资期望，并确认您的技能清单。克劳德从你的简历中提取原始数据；该向导填补了简历中自然不包含的空白。
就是这样。从那里开始，每个工具都有关于你是谁的完整背景。
______________________________________________________________________
数据结构
Career Compass将所有数据存储为YAML文件：
~/.career-compass/
├── career/
│ ├── profile.yaml # Name, summary, targets, preferences
│ ├── experience.yaml # Work history with achievements
│ ├── skills.yaml # Skills with proficiency ratings
│ ├── education.yaml # Degrees and certifications
│ ├── projects.yaml # Portfolio projects
│ └── testimonials.yaml # Recommendations and quotes
└── pipeline/
└── applications.yaml # All job applications集 CAREER_DATA_PATH 使用自定义目录。违约： ~/.career-compass
______________________________________________________________________
仪表板CLI
career-compass-mcp dashboard # open dashboard (default port 3141)
career-compass-mcp dashboard --port 3000 # specify port
career-compass-mcp dashboard --no-open # start server without opening browser______________________________________________________________________
工具
| 工具 | 它做什么 |
|---|---|
explore_opportunity | 根据你的职业知识库分析招聘信息——适合度得分、匹配优势、差距、谈话要点、生活中的一天、危险信号 |
research_company | 构建情报简报：产品、文化、资金、面试流程、战略契合度 |
tailor_resume | 从您的知识库中生成经过ATS优化、量身定制的简历——标准、联邦、学术或职能格式 |
generate_cover_letter | 写一封个性化的求职信，将你的实际成就融入其中 |
format_for_ats | 重新格式化特定ATS系统的简历内容：Workday、Greenhouse、Lever、LinkedIn、iCIMS、Taleo |
manage_pipeline | 从发现到提供跟踪应用程序——添加、更新、列表、统计数据、下一步操作 |
classify_email | 对求职电子邮件进行分类，并提取联系人、日期和建议的管道更新 |
prepare_interview | 完整的面试准备：开场白、明星故事、可能的问题、公司定位、要问的问题 |
evaluate_offer | 分解总薪酬，与市场进行比较，制定谈判策略，起草反脚本 |
ingest_document | 从任何文档中提取成就：绩效评估、奖励电子邮件、领英推荐、项目总结 |
generate_rejection_response | 起草一个优雅的回应，让大门敞开，维持关系 |
资源
克劳德可以直接阅读这些（例如，“阅读我的职业简介”）：
| 资源 | URI | 内容 |
|---|---|---|
| 职业简介 | career://profile | 姓名、联系人、摘要、目标、偏好 |
| 工作经历 | career://experience | 成就的完整历史 |
| 技能清单 | career://skills | 熟练和新颖的技能 |
| 项目 | career://projects | 有成果的投资组合 |
| 教育 | career://education | 学位、证书、课程 |
| 客户见证 | career://testimonials | 报价、建议 |
| 完整KB | career://full | 以上内容一读即可 |
| 管道 | career://pipeline | 所有具有状态的应用程序 |
提示
高级用户快捷键（出现在Claude的提示菜单中）：
| 提示 | 它做什么 |
|---|---|
resume-tailor | 投递帖子→ 获得量身定制的简历 |
interview-coach | 公司+职位+面试类型→ 完整的准备包 |
negotiation-coach | 粘贴报价→ 获取分析、策略和对策脚本 |
______________________________________________________________________
您的职业知识库
您的数据存储在YAML文件中 CAREER_DATA_PATH:
career-data/
├── career/
│ ├── profile.yaml ← who you are, what you're targeting
│ ├── experience.yaml ← roles, achievements (metrics + context + impact)
│ ├── skills.yaml ← skills with proficiency and recency
│ ├── education.yaml ← degrees, certs, coursework
│ ├── projects.yaml ← portfolio
│ └── testimonials.yaml ← quotes and recommendations
└── pipeline/
└── applications.yaml ← all job applications你永远不需要手动编辑这些。使用 ingest_document 通过粘贴文档添加数据，或要求Claude更新特定部分。
看 data/example/ 在这个仓库中，有一个完全填充的示例。
______________________________________________________________________
配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
CAREER_DATA_PATH | ./data | YAML文件的存储位置 |
______________________________________________________________________
从源头构建
git clone https://github.com/benskamps/career-compass-mcp
cd career-compass-mcp
npm install
npm run buildnpm run build 编译MCP服务器（TypeScript→ build/)Next.js控制面板(dashboard/.next/).要仅在MCP服务器上工作，请使用 npm run build:mcp。对于具有热重载功能的仪表板开发，请使用 npm run dev:dashboard.
然后将MCP配置指向 node /path/to/career-compass-mcp/build/src/index.js.
使用 npm run dev 在开发过程中——TypeScript监视模式在保存时重新编译。 使用 npm run inspect 打开MCP检查器（交互式测试工具的web UI）。
______________________________________________________________________
为什么选择职业指南针
求职是大多数人从事的风险最高、文档最密集的活动之一，大多数工具都将其视为数据输入问题。用于跟踪的电子表格。简历模板。面试的通用建议。
职业指南针将其视为一个知识问题。你的职业生涯是一个语料库。每个应用程序都是一个检索和综合任务。每次面试都是一个针对已知数据集（帖子）和已知语料库（你的知识库）的模式匹配问题。
Career知识库是您唯一的真理来源——只需构建一次，随着时间的推移而丰富，并被每个工具使用。一份量身定制的简历从中汲取灵感。面试准备从中汲取能量。求职信从中汲取力量。管道会根据它进行跟踪。没有什么会丢失，因为它永远不会出现在你要关闭的标签中。
______________________________________________________________________
发展
git clone https://github.com/benskamps/career-compass-mcp.git
cd career-compass-mcp
npm install
cd dashboard && npm install && cd ..
# MCP server (TypeScript watch)
npm run dev
# Dashboard (Next.js + Turbopack)
npm run dev:dashboard
# MCP Inspector (test tools interactively)
npm run inspect
# Tests
npm run test:mcp # MCP server tests
npm run test # Dashboard tests
# Storybook (component library)
npm run storybook
# Use example data for development
CAREER_DATA_PATH=data/example npm run dev:dashboard______________________________________________________________________
贡献
欢迎发布问题和PR。如果添加新工具，请在中注册 src/server.ts 并遵循任何现有工具文件中的模式——每个工具都返回一个结构化的提示，Claude在上下文中使用完整的KB对其进行操作。
______________________________________________________________________
许可证
麻省理工学院