jobseek-mcp 0.1.0 → 0.3.0

package/README.md

@@ -51,6 +51,18 @@ After saving the config, restart Claude Code. Type `/mcp` to verify the server i
 
 ## Available Tools
 
+### `upload_resume`
+Upload a PDF resume to JobSeek.
+
+**Example prompts:**
+- "Upload my resume from ~/Documents/resume.pdf"
+- "Upload /Users/me/Downloads/Resume_2025.pdf to JobSeek"
+
+**What it does:**
+- Reads PDF from your local filesystem
+- Extracts text and parses with AI
+- Stores the parsed resume in JobSeek
+
 ### `optimize_resume`
 Optimize your resume for ATS (Applicant Tracking Systems).
 

package/dist/index.js

@@ -4,13 +4,15 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { optimizeResumeTool, handleOptimizeResume } from "./tools/optimize-resume.js";
 import { downloadResumePdfTool, handleDownloadResumePdf } from "./tools/download-resume-pdf.js";
+import { uploadResumeTool, handleUploadResume } from "./tools/upload-resume.js";
+import { allResources, handleReadResource } from "./resources.js";
 // Configuration
 const JOBSEEK_API_URL = process.env.JOBSEEK_API_URL || "https://jobseek-iota.vercel.app";
 const JOBSEEK_API_KEY = process.env.JOBSEEK_API_KEY;
 // Create the MCP server
 const server = new Server({
     name: "jobseek-mcp",
-    version: "0.1.0",
+    version: "0.3.0",
 }, {
     capabilities: {
         tools: {},
@@ -23,6 +25,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         tools: [
             optimizeResumeTool,
             downloadResumePdfTool,
+            uploadResumeTool,
         ],
     };
 });
@@ -34,6 +37,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return handleOptimizeResume(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
         case "download_resume_pdf":
             return handleDownloadResumePdf(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
+        case "upload_resume":
+            return handleUploadResume(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
         default:
             throw new Error(`Unknown tool: ${name}`);
     }
@@ -41,15 +46,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 // List available resources
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     return {
-        resources: [
-        // Resources will be added here (resume, applications, etc.)
-        ],
+        resources: allResources,
     };
 });
 // Handle resource reads
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const { uri } = request.params;
-    throw new Error(`Unknown resource: ${uri}`);
+    return handleReadResource(uri);
 });
 // Start the server
 async function main() {

package/dist/resources.d.ts

@@ -0,0 +1,25 @@
+export declare const resumeResource: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
+export declare const applicationsResource: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
+export declare const allResources: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+export declare function handleReadResource(uri: string): Promise<{
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+}>;

package/dist/resources.js

@@ -0,0 +1,122 @@
+// Resource definitions and handlers for MCP
+// Configuration
+const getApiUrl = () => process.env.JOBSEEK_API_URL || "https://getjobseek.com";
+const getApiKey = () => process.env.JOBSEEK_API_KEY;
+// Resource definitions
+export const resumeResource = {
+    uri: "jobseek://resume",
+    name: "Current Resume",
+    description: "Your resume data stored in JobSeek including skills, experience, education, and summary",
+    mimeType: "application/json"
+};
+export const applicationsResource = {
+    uri: "jobseek://applications",
+    name: "Job Applications",
+    description: "Your tracked job applications with status, company, and match scores",
+    mimeType: "application/json"
+};
+// All resources
+export const allResources = [
+    resumeResource,
+    applicationsResource,
+];
+// Fetch resume data
+async function fetchResume() {
+    const apiKey = getApiKey();
+    const apiUrl = getApiUrl();
+    if (!apiKey) {
+        return JSON.stringify({
+            error: "No API key configured",
+            help: "Get your API key at " + apiUrl + "/dashboard/api-keys"
+        }, null, 2);
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/resumes/current`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return JSON.stringify({
+                    error: "Invalid API key",
+                    help: "Generate a new key at " + apiUrl + "/dashboard/api-keys"
+                }, null, 2);
+            }
+            if (response.status === 404) {
+                return JSON.stringify({
+                    error: "No resume found",
+                    help: "Upload a resume first using the upload_resume tool"
+                }, null, 2);
+            }
+            return JSON.stringify({
+                error: `Failed to fetch resume: ${response.status}`
+            }, null, 2);
+        }
+        const data = await response.json();
+        return JSON.stringify(data, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: `Network error: ${error.message}`
+        }, null, 2);
+    }
+}
+// Fetch applications data
+async function fetchApplications() {
+    const apiKey = getApiKey();
+    const apiUrl = getApiUrl();
+    if (!apiKey) {
+        return JSON.stringify({
+            error: "No API key configured",
+            help: "Get your API key at " + apiUrl + "/dashboard/api-keys"
+        }, null, 2);
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/applications`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return JSON.stringify({
+                    error: "Invalid API key"
+                }, null, 2);
+            }
+            return JSON.stringify({
+                error: `Failed to fetch applications: ${response.status}`
+            }, null, 2);
+        }
+        const data = await response.json();
+        return JSON.stringify(data, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: `Network error: ${error.message}`
+        }, null, 2);
+    }
+}
+// Handle resource reads
+export async function handleReadResource(uri) {
+    switch (uri) {
+        case "jobseek://resume":
+            return {
+                contents: [{
+                        uri,
+                        mimeType: "application/json",
+                        text: await fetchResume()
+                    }]
+            };
+        case "jobseek://applications":
+            return {
+                contents: [{
+                        uri,
+                        mimeType: "application/json",
+                        text: await fetchApplications()
+                    }]
+            };
+        default:
+            throw new Error(`Unknown resource: ${uri}`);
+    }
+}

package/dist/tools/upload-resume.d.ts

@@ -0,0 +1,20 @@
+export declare const uploadResumeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleUploadResume(args: unknown, apiUrl: string, apiKey?: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/tools/upload-resume.js

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import * as fs from "fs";
+import * as path from "path";
+// Tool definition
+export const uploadResumeTool = {
+    name: "upload_resume",
+    description: "Upload a resume PDF to JobSeek. The resume will be parsed and stored, enabling optimization and job matching features. Accepts a file path to a PDF file.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "Absolute path to the PDF file to upload (e.g., /Users/name/Documents/resume.pdf or ~/Downloads/resume.pdf)"
+            }
+        },
+        required: ["filePath"]
+    }
+};
+// Input validation
+const UploadResumeInput = z.object({
+    filePath: z.string().min(1, "File path is required")
+});
+// Expand ~ to home directory
+function expandPath(filePath) {
+    if (filePath.startsWith('~')) {
+        return path.join(process.env.HOME || '', filePath.slice(1));
+    }
+    return filePath;
+}
+// Tool handler
+export async function handleUploadResume(args, apiUrl, apiKey) {
+    const input = UploadResumeInput.parse(args);
+    const expandedPath = expandPath(input.filePath);
+    // Validate file exists
+    if (!fs.existsSync(expandedPath)) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **File Not Found**\n\nCould not find file: ${input.filePath}\n\nPlease check the path and try again.`
+                }]
+        };
+    }
+    // Validate it's a PDF
+    if (!expandedPath.toLowerCase().endsWith('.pdf')) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **Invalid File Type**\n\nOnly PDF files are supported. Please provide a .pdf file.`
+                }]
+        };
+    }
+    // Read file and convert to base64
+    const fileBuffer = fs.readFileSync(expandedPath);
+    const base64Data = fileBuffer.toString('base64');
+    const fileName = path.basename(expandedPath);
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (apiKey) {
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        }
+        const response = await fetch(`${apiUrl}/api/resumes/upload`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                pdfBase64: base64Data,
+                fileName
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: "Unknown error" }));
+            if (response.status === 401) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Authentication Required**\n\nPlease configure your API key. Get one at: ${apiUrl}/dashboard/api-keys`
+                        }]
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Upload Failed**\n\n${error.error || error.message || 'Unknown error'}`
+                    }]
+            };
+        }
+        const result = await response.json();
+        return {
+            content: [{
+                    type: "text",
+                    text: `✅ **Resume Uploaded Successfully!**
+
+**File:** ${result.fileName}
+
+**Parsed Data:**
+- Skills detected: ${result.skillsCount}
+- Experience entries: ${result.experienceCount}
+
+**Summary:**
+${result.summary || 'No summary extracted'}
+
+---
+
+Your resume is now stored in JobSeek. You can:
+- Run "optimize my resume for ATS" to improve it
+- Analyze job postings for match scores
+- Download optimized versions`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **Error**\n\nFailed to upload resume: ${error.message}`
+                }]
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jobseek-mcp",
-    "version": "0.1.0",
+    "version": "0.3.0",
     "description": "JobSeek MCP Server - AI-powered job search automation for Claude Code",
     "author": "Shawn Mitchell",
     "license": "MIT",
@@ -44,4 +44,4 @@
     "engines": {
         "node": ">=18"
     }
-}
+}