Skip to main content
Glama
Miriam-Epstein

career-navigator-mcp

by Miriam-Epstein
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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: crosswalk-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)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Jobs Recommender Agent

    jsuryanm
    A
    license
    Not graded
    quality
    D
    maintenance
    An AI-powered job recommender built on the Model Context Protocol that provides personalized career suggestions through resume and skills matching. It utilizes LLMs and external tool integrations to help users find relevant job openings based on their professional profile.
    MIT

  • Interactive Curriculum MCP

    AnaCataVC
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants and LLM clients to query a professional CV and portfolio, including work history, technical skills, projects, job compatibility evaluation, education, and contact details.
    MIT

  • La Bàn

    dungnotnull
    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.
    26 npm
    3
    GPL 3.0