career-navigator-mcp
career-navigator-mcp
An MCP (Model Context Protocol) server that exposes the career diagnosis AI system as callable tools — powered by Google Gemini and a RAG knowledge base of 10 professions.
Any MCP-compatible client (Claude Desktop, Cursor, etc.) can integrate this server and call its tools directly.
Tools
analyze_skills
Analyzes free text describing a user and returns a list of skills with match percentages.
Input:
{ "text": "I enjoy working with people and solving complex problems..." }Output:
[
{ "skill": "Interpersonal Communication", "match_percentage": 95 },
{ "skill": "Problem Solving", "match_percentage": 85 }
]recommend_profession
Receives a skills array and recommends the most suitable profession using RAG — matched against a real knowledge base of 10 professions.
Input:
{
"skills": [
{ "skill": "Interpersonal Communication", "match_percentage": 95 },
{ "skill": "Problem Solving", "match_percentage": 85 }
]
}Output:
[
{
"profession": "מנהל משאבי אנוש",
"match_percentage": 91,
"explanation": "..."
}
]Related MCP server: @interviewsage/mcp
Architecture
MCP Client (Claude Desktop / Cursor / any AI agent)
│
│ tools/call: analyze_skills / recommend_profession
▼
career-navigator-mcp (StdioServerTransport)
│
├── analyze_skills ──► Gemini API (structured JSON output)
│
└── recommend_profession ──► RAG: professions_data.json
└── top 3 matches injected into Gemini promptSetup
Prerequisites
Node.js 18+
A
GEMINI_API_KEYfrom Google AI Studio
Install
git clone https://github.com/Miriam-Epstein/career-navigator-mcp.git
cd career-navigator-mcp
npm installEnvironment
Create a .env file in the project root:
GEMINI_API_KEY=your_key_hereConnecting to Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"career-navigator": {
"command": "node",
"args": ["/absolute/path/to/career-navigator-mcp/index.js"]
}
}
}Model Fallback
Every Gemini call uses an automatic fallback chain:
gemini-2.5-flash-lite → (on 429 / quota error) → gemini-2.5-flashTech Stack
Layer | Technology |
Protocol | MCP SDK ( |
Transport | StdioServerTransport |
AI | Google Gemini ( |
RAG | Local JSON knowledge base (10 professions) |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
This server cannot be deployed
Maintenance
Related MCP Connectors
The career management plugin for your own AI assistant: CVs, cover letters, interviews and more.
AI-powered career tools: job search, skills intelligence, career roadmaps, and resume building.
Your career companion for ATS checks, resumes, cover letters, job tracking, websites, and more.
CareerProof MCP gives AI agents direct access to a professional-grade career and workforce intelligence platform. Two namespaces: atlas_* for HR/TA teams (candidate evaluation, batch shortlisting, competency scoring, interview generation, JD analysis, custom eval frameworks, research reports) and ceevee_* for professionals (CV optimization, career positioning, salary intelligence, market reports). Backed by RAG knowledge from 50+ premium research sources (McKinsey, BCG, HBR, Gartner, WEF)
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to act as career counselors for Vietnamese workers by querying verified occupation and research data, analyzing transitions, and co-creating action plans that require human approval before any changes are saved.14 npm3GPL 3.0
- AlicenseAqualityCmaintenanceEnables AI assistants to access career-coaching tools: article search, Holland assessment, interview question bank, resume diagnosis and rewrites, mock interview coaching, interview prediction, and OCR exam search, all relayed to a backend service.106 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to search job listings and retrieve or update a user's career profile, including work experiences, job summaries, career goals, and technical skills through natural language.-
- FlicenseNot gradedqualityAmaintenanceEnables users to search and view job postings, and to retrieve or update their professional history, job summary, career aspirations, and technical skills through natural language.-