career-scout-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@career-scout-mcp score my resume for senior data scientist roles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
career-scout-mcp
A production-grade Model Context Protocol (MCP) server demonstrating the wrapping pattern for AI-augmented data pipelines. Built as a standalone artifact: one LXC container, one Cloudflare Tunnel, one repo. Self-hosted via Ollama + LiteLLM SDK.
This server demonstrates the pattern I would apply to wrap Career Scout — my private job-search scoring pipeline. Synthetic data committed here for portability and reproducibility.
Documentation
Full architecture and design decisions: career-scout-mcp.stojadinovic.at
Related MCP server: jobjourney-claude-plugin
Stack
Python 3.13 (mypy strict)
MCP SDK with decorator-based primitive registration
LiteLLM SDK — provider-agnostic LLM routing, model-swappable via env
Ollama + Qwen 2.5 3B (default) — self-hosted, biomedical-research-portable
Pydantic for config + tool schemas
loguru structured JSON logging with secret redaction
Debian 13 LXC, cloudflared edge termination, nginx static docs
Prerequisites
Python 3.13 (uv manages this automatically)
uv — dependency and environment management
Ollama — default local LLM provider for
qwen2.5:3b
Memory: Ollama's headroom calc for qwen2.5:3b requires ~6 GiB of available memory (it counts buff/cache as unavailable). A 4 GiB system may fail to load the model even though it's 1.9 GB on disk.
Debian 13
sudo apt-get update && sudo apt-get install -y curl ca-certificates zstd
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:3bNote:
zstdis required by the Ollama installer for archive extraction on minimal Debian; not all base images include it.
macOS
brew install uv ollama
ollama serve &
ollama pull qwen2.5:3bWindows
uv installer · Ollama installer, then ollama pull qwen2.5:3b.
Quick start (local stdio)
uv sync
uv run python -m career_scout_mcpThe server exposes 4 tools, 5 resources (6 URIs), and 2 prompts via stdio. Connect from Claude Desktop, Claude Code, or OpenCode by pointing them at this binary.
Try it out
The fastest way to exercise the server is via MCP Inspector:
npx @modelcontextprotocol/inspector uv run python -m career_scout_mcpOpens a browser UI at localhost:6274 where you can list resources, render prompts, and invoke tools end-to-end against your local Ollama.
Development
Dev workflow uses OpenCode + standard Python tooling. See CONTRIBUTING.md.
Security
See SECURITY.md for reporting. Key posture:
All SQL parameterized (never f-string)
Pydantic input validation on every tool entry
Path traversal prevention on resource URIs
systemd hardening (non-root, ProtectSystem=strict, etc.)
MCP server NEVER publicly exposed (stdio default, HTTP bound 127.0.0.1 only)
TLS via Cloudflare edge — no local cert management surface
Docs deploy via manual
scripts/deploy_docs.sh. MCP server is never publicly exposed — stdio default; HTTP transport loopback-only behind Bearer auth (hmac.compare_digest).
License
MIT — see LICENSE.
Built by Stefan Stojadinovic, Vienna. Contact: stefan@stojadinovic.at
Available Tools
4 toolsquery_postingsB
List postings matching the filter criteria, with their latest score.
Returns only postings that have at least one score (the JOIN excludes never-scored ones). Empty result is valid output.
Inputs: limit, min_score, date_after, role_anchor. Returns: result
regenerate_digestA
Render a digest HTML of the current top-20 postings.
Output path is settings.digest_output_path (operator-controlled, not user-input — no path traversal vector). Writes a single self-contained HTML file with minimal inline styling.
Inputs: no named parameters. Returns: Output of regenerate_digest.
rescore_postingA
Re-score one posting against the current rubric via the configured LLM.
Loads the posting, loads the current rubric, scores it via LiteLLM, persists the new score row, and returns the structured result. Raises ValueError if posting not found; ScoringError on LLM/parse failure.
Inputs: posting_id (required). Returns: LLM-produced scoring result. Distinct from the DB Score row.
tag_mismatched_scoreB
Record that a stored score does not match operator judgment.
Writes to tagged_mismatches.db. The tune_rubric prompt aggregates these for rubric refinement workflows. Reason must be non-empty.
Inputs: reason (required), posting_id (required), expected_band (required). Returns: Acknowledgement returned by write-only tools.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct action: re-scoring, tagging mismatches, querying postings, and generating a digest. No overlap in purpose.
All tool names follow the verb_noun pattern in snake_case, providing a predictable and consistent naming convention.
With 4 tools, the server is well-scoped for focused tasks like scoring, mismatch recording, querying, and digest generation without being too heavy or too thin.
The set covers scoring, discrepancy tracking, and reporting but lacks tools for CRUD operations on postings or rubric management, leaving notable gaps in a typical career management workflow.
Maintenance
Related MCP Connectors
MCP server for VC pitch-deck scoring, thesis-fit matching, and deal-flow management.
MCP Hub: AI service discovery, per-user OAuth, and multi-service workflow orchestration
Hosted MCP server for pre-action AI governance verdicts, model routing, and evidence verification.
41MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-grade MCP server designed for multi-tenant, authenticated, and observable AI agent systems, enabling secure tool execution across heterogeneous data sources.68MIT
- AlicenseCqualityCmaintenanceAn MCP server that enables AI-assisted job search workflows including job discovery, application tracking, resume evaluation, and cover letter generation, with support for multiple job sources and scheduled scraping.8356 npm1AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceA custom MCP server that exposes a jobs database to any MCP-compatible LLM client, allowing users to ask in plain English to search, filter, and match job openings.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that aggregates and deduplicates job listings from multiple public sources, ranks them against a user's resume, and exposes tools for searching, viewing details, explaining fit, and tracking applications.MIT