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

• 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 (12 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.