MCP JobPilot Africa

🌟 If you find this project impactful, please give it a Star on GitHub! It helps African tech talent gain visibility across the global AI ecosystem.

MCP JobPilot Africa is an AI-powered Model Context Protocol (MCP) server designed to match African early-career talent with tech internships and job opportunities. It equips AI agents with tools for discovery, profile matching, gap analysis, application tracking, and interview coaching.

🎯 Features

Continental scope: JobPilot Africa supports discovery across all 55 African Union members and five regions, independently of the countries represented in its demo jobs. Country aliases work across French and English. See continental coverage and direction.

• Pasted offer analysis: Compare an external job posting with a candidate's skills, review quoted evidence, and save reports locally. See scope and API.

• Job Discovery: Search tech opportunities across Africa by keyword, country, remote allowance, and contract duration.

• Skill Matching & Gap Analysis: Match candidate profiles against job prerequisites, compute match scores (0–100%), and receive targeted learning recommendations.

• Application Tracking: Create and maintain candidate job applications with custom notes and status lifecycles (saved, applied, interview, offer, rejected).

• Interview Preparation: Generate contextual technical and behavioral interview questions tailored to the candidate's profile and the employer's stack.

• Preparation Checklist: Generate an actionable, prioritized preparation plan for upcoming interviews.

Related MCP server: Civify MCP Server

📂 Project Structure

mcp-jobpilot-africa/
├── data/                  # Demo JSON profiles and local SQLite storage
│   ├── candidates.json
│   └── jobs.json
├── docs/                  # Architecture & Tool documentation
│   ├── architecture.md
│   └── tools.md
├── src/
│   └── jobpilot/
│       ├── database/      # SQLite connection, schema, and demo seed
│       ├── models/        # Pydantic v2 schemas (Job, Candidate, Application, MatchResult, ...)
│       ├── services/      # Business logic (matching, job search, interview prep)
│       ├── tools/         # FastMCP tools
│       ├── mcp_app.py     # Shared FastMCP server instance
│       └── server.py      # Entrypoint & CLI runner (stdio, sse, http)
└── tests/                 # Isolated pytest suite with dynamic SQLite fixtures

🚀 Quick Start

1. Installation

# Clone the repository
git clone https://github.com/Damasoumana1/mcp-jobpilot-africa-.git
cd mcp-jobpilot-africa-

# Create and activate virtual environment
python -m venv .venv

# On Windows:
.venv\Scripts\activate
# On Linux/macOS:
source .venv/bin/activate

# Install in editable mode
pip install -e .

2. Run the Server

Standard IO (stdio - Recommended for Claude Desktop / Cursor / Cline):

python -m jobpilot.server

Server-Sent Events (sse):

python -m jobpilot.server --transport sse --host 127.0.0.1 --port 8000

Interactive Web Dashboard:

python -m jobpilot.server --web
# Ou directement :
python -m jobpilot.web

Ouvrez ensuite votre navigateur sur http://localhost:8000 pour explorer les offres, tester le matching en direct, suivre vos candidatures et générer vos questions d'entretien.

FastMCP Dev Inspector:

fastmcp dev inspector src/jobpilot/server.py:mcp

🔌 Connecting to Claude Desktop / Cursor

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "jobpilot-africa": {
      "command": "python",
      "args": [
        "-m",
        "jobpilot.server"
      ],
      "cwd": "C:/Users/user/Desktop/mcp-jobpilot-africa"
    }
  }
}

🛠️ MCP Tools Overview (17 Tools)

🧪 Running Tests

The test suite runs with fully isolated, temporary SQLite databases:

pytest -v

💻 Modern Web UI (Vite + React 19 + Tailwind CSS)

To launch the modern frontend application:

cd frontend
npm install
npm run dev

Open http://localhost:5173 in your browser to experience:

• Interactive tech job explorer with continent-wide filters and remote badges

• Real-time AI weighted matching score with visual breakdown & skill gaps

• Application pipeline with status tracking (saved, applied, interview, offer, rejected)

• Interview studio with AI question generation and preparation checklists

• Tailored cover letter & LinkedIn pitch generator with 1-click clipboard copy

• Floating AI Career Copilot assistant

🤝 Contributing & Community

We are building MCP JobPilot Africa as an open-source, community-driven ecosystem to accelerate early-career tech talent across the African continent! Contributions of all forms are celebrated and welcomed:

• 💼 Add tech jobs: Use our Submit Job Form to add local and remote opportunities.

• 🤖 Build MCP tools: Extend src/jobpilot/tools/ with new agentic capabilities (resume parsing, skill verification, mock audio interviews).

• 🎨 Enhance the Web UI: Improve React components, Tailwind styling, charts, or accessibility.

• 🌍 Internationalization (i18n): Help translate JobPilot Africa into French, Arabic, Swahili, Portuguese, and more.

• 🐛 Report issues: Found a bug or edge case? Open an issue using our Bug Report Form.

👥 Contributors Hall of Fame

A massive thank you to everyone shaping the future of African tech talent! 🌟

Check out our Contributing Guide and Code of Conduct to make your first commit.

📄 License

Distributed under the MIT License.