Skip to main content
Glama

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 prompt

Setup

Prerequisites

Install

git clone https://github.com/Miriam-Epstein/career-navigator-mcp.git
cd career-navigator-mcp
npm install

Environment

Create a .env file in the project root:

GEMINI_API_KEY=your_key_here

Connecting 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-flash

Tech Stack

Layer

Technology

Protocol

MCP SDK (@modelcontextprotocol/sdk)

Transport

StdioServerTransport

AI

Google Gemini (@google/genai)

RAG

Local JSON knowledge base (10 professions)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      3
      GPL 3.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      6 npm
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -