cp .env.example .env
# Edit .env and fill in your LinkedIn email and password

# Build the Docker image
docker build -t linkedin-mcp .

# Quick smoke test — should print the MCP server startup log
docker run --rm --env-file .env linkedin-mcp
# Ctrl+C to stop

{
  "mcpServers": {
    "linkedin-jobs": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--env-file", "/ABSOLUTE/PATH/TO/linkedin-mcp/.env",
        "linkedin-mcp"
      ]
    }
  }
}

You: Check if my LinkedIn session is authenticated
Claude: [calls check_auth] ✓ Authenticated as John Doe

You: Scrape 20 AI Engineer or ML Engineer jobs posted in the last 3 days in the US
Claude: [calls scrape_jobs] ...returns full job list with descriptions

# Run with live source reloading
docker compose up

# Inspect MCP tools without Claude Desktop
npx @modelcontextprotocol/inspector docker run --rm -i --env-file .env linkedin-mcp

linkedin-mcp/
├── src/
│   ├── server.py        # MCP server — tool definitions and handlers
│   ├── scraper.py       # linkedin-api Voyager wrapper calls
│   ├── models.py        # Pydantic models for Job data
│   └── __init__.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── .env.example
└── .gitignore