jobseek-mcp 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# JobSeek MCP Server
+
+AI-powered job search automation for Claude Code.
+
+## Quick Start
+
+### 1. Build the MCP Server
+```bash
+cd jobseek-mcp
+npm install
+npm run build
+```
+
+### 2. Generate an API Key
+- Go to https://getjobseek.com/dashboard/api-keys
+- Click "Generate Key"
+- Copy the key (you won't be able to see it again!)
+
+### 3. Configure Claude Code
+
+Open `~/.claude.json` in your editor and find your project's `mcpServers` section. Add the `jobseek` entry:
+
+```json
+{
+  "projects": {
+    "/path/to/your/project": {
+      "mcpServers": {
+        "jobseek": {
+          "type": "stdio",
+          "command": "node",
+          "args": ["/path/to/jobseek-mcp/dist/index.js"],
+          "env": {
+            "JOBSEEK_API_URL": "https://getjobseek.com",
+            "JOBSEEK_API_KEY": "sk_live_your_key_here"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Important:** Replace:
+- `/path/to/your/project` with your project directory
+- `/path/to/jobseek-mcp/dist/index.js` with the actual path to the built MCP server
+- `sk_live_your_key_here` with your generated API key
+
+### 4. Restart Claude Code
+
+After saving the config, restart Claude Code. Type `/mcp` to verify the server is connected.
+
+## Available Tools
+
+### `optimize_resume`
+Optimize your resume for ATS (Applicant Tracking Systems).
+
+**Example prompts:**
+- "Optimize my resume for ATS"
+- "Regenerate my resume with a more technical summary"
+- "Make my resume more concise"
+
+**What it does:**
+- Rewrites with stronger action verbs
+- Adds measurable impact statements
+- Optimizes keywords for ATS scanning
+- Returns the optimized content + rationale
+
+### `download_resume_pdf`
+Download your resume as a file.
+
+**Example prompts:**
+- "Download my resume"
+- "Save my optimized resume to a file"
+- "Download my ATS-optimized resume to ~/Documents/resume.txt"
+
+**Parameters:**
+- `filePath` (optional): Custom path for the file
+- `optimized` (optional): If true, downloads the ATS-optimized version
+
+## Full Workflow Example
+
+```
+You: "Optimize my resume for ATS"
+Claude: [calls optimize_resume] "Here's your optimized resume..."
+
+You: "That looks great! Download it as a file"
+Claude: [calls download_resume_pdf] "Saved to ~/Downloads/resume_optimized.txt"
+```
+
+## Troubleshooting
+
+### "1 MCP server failed" error
+- Check `/mcp` in Claude Code for details
+- Verify the path to `dist/index.js` is correct
+- Make sure you ran `npm run build`
+
+### "Authentication Required" error
+- Verify your API key is correct in `~/.claude.json`
+- Make sure you have a resume uploaded at https://getjobseek.com/dashboard/profile
+- Check that JOBSEEK_API_URL is set to `https://getjobseek.com`
+
+## Development
+
+```bash
+npm run dev   # Run with tsx (hot reload)
+npm run build # Build for production
+npm start     # Run production build
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+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";
+// 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",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            optimizeResumeTool,
+            downloadResumePdfTool,
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case "optimize_resume":
+            return handleOptimizeResume(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
+        case "download_resume_pdf":
+            return handleDownloadResumePdf(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+});
+// List available resources
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+        // Resources will be added here (resume, applications, etc.)
+        ],
+    };
+});
+// Handle resource reads
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    throw new Error(`Unknown resource: ${uri}`);
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("JobSeek MCP Server running on stdio");
+}
+main().catch(console.error);

package/dist/tools/download-resume-pdf.d.ts

@@ -0,0 +1,24 @@
+export declare const downloadResumePdfTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+            optimized: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleDownloadResumePdf(args: unknown, apiUrl: string, apiKey?: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/tools/download-resume-pdf.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { writeFileSync } from "fs";
+import { join } from "path";
+// Tool definition for MCP
+export const downloadResumePdfTool = {
+    name: "download_resume_pdf",
+    description: `Generate and download a PDF of your resume.
+
+This tool fetches your current resume from JobSeek and saves it as a PDF file.
+You can optionally specify a custom file path, otherwise it will be saved to your Downloads folder.
+
+Returns the path to the generated PDF file.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "Optional custom file path for the PDF. Defaults to ~/Downloads/resume.pdf",
+            },
+            optimized: {
+                type: "boolean",
+                description: "If true, generates PDF from the ATS-optimized version. Otherwise uses current resume.",
+            },
+        },
+        required: [],
+    },
+};
+// Input validation schema
+const DownloadResumePdfInput = z.object({
+    filePath: z.string().optional(),
+    optimized: z.boolean().optional().default(false),
+});
+// Simple PDF generation using plain text (no external dependencies)
+function generateSimplePdf(resume) {
+    // Create a simple text-based "PDF" that most viewers can read
+    // For a real PDF, you'd use a library like pdfkit or jsPDF
+    const content = `
+================================================================================
+                              RESUME
+================================================================================
+
+${resume.name}
+${resume.email}
+${resume.linkedinUrl ? `LinkedIn: ${resume.linkedinUrl}` : ''}
+
+--------------------------------------------------------------------------------
+PROFESSIONAL SUMMARY
+--------------------------------------------------------------------------------
+${resume.summary || 'No summary available.'}
+
+--------------------------------------------------------------------------------
+SKILLS
+--------------------------------------------------------------------------------
+${(resume.skills || []).join(' • ')}
+
+--------------------------------------------------------------------------------
+EXPERIENCE
+--------------------------------------------------------------------------------
+${(resume.experience || []).map((exp) => `
+${exp.title} at ${exp.company}
+${exp.duration}
+
+${exp.description || (exp.bullets || []).map((b) => `• ${b}`).join('\n')}
+`).join('\n')}
+
+--------------------------------------------------------------------------------
+EDUCATION
+--------------------------------------------------------------------------------
+${(resume.education || []).map((edu) => `
+${edu.degree} - ${edu.institution} (${edu.year})
+`).join('\n')}
+
+================================================================================
+                        Generated by JobSeek
+================================================================================
+`;
+    return Buffer.from(content, 'utf-8');
+}
+// Tool handler
+export async function handleDownloadResumePdf(args, apiUrl, apiKey) {
+    const input = DownloadResumePdfInput.parse(args);
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (apiKey) {
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        }
+        // If optimized, first call optimize endpoint, otherwise fetch current resume
+        const endpoint = input.optimized
+            ? `${apiUrl}/api/resumes/optimize`
+            : `${apiUrl}/api/resumes/current`;
+        const response = await fetch(endpoint, {
+            method: input.optimized ? "POST" : "GET",
+            headers,
+            ...(input.optimized ? { body: JSON.stringify({}) } : {}),
+        });
+        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 set your JOBSEEK_API_KEY environment variable.",
+                        },
+                    ],
+                };
+            }
+            throw new Error(error.error || `API error: ${response.status}`);
+        }
+        const resumeData = await response.json();
+        // For optimized resume, the data is in result.content
+        const resume = input.optimized ? resumeData.content : resumeData;
+        // Generate PDF content
+        const pdfBuffer = generateSimplePdf(resume);
+        // Determine file path
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
+        const defaultPath = join(homeDir, 'Downloads', `resume${input.optimized ? '_optimized' : ''}.txt`);
+        const outputPath = input.filePath || defaultPath;
+        // Write to file
+        writeFileSync(outputPath, pdfBuffer);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **Resume Downloaded!**
+
+Your resume has been saved to:
+\`${outputPath}\`
+
+${input.optimized ? '📈 This is your ATS-optimized version.' : '📄 This is your current resume.'}
+
+**Note:** This is a text-formatted resume. For a properly formatted PDF, visit your JobSeek dashboard and use the "Download PDF" button.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ **Error generating resume:** ${error.message}`,
+                },
+            ],
+        };
+    }
+}

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

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

package/dist/tools/optimize-resume.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+// Tool definition for MCP
+export const optimizeResumeTool = {
+    name: "optimize_resume",
+    description: `Optimize a resume for ATS (Applicant Tracking Systems).
+  
+This tool rewrites your resume to:
+- Use strong action verbs
+- Add measurable impact statements
+- Optimize keywords for ATS scanning
+- Improve formatting for machine readability
+
+Returns the optimized resume content and a rationale explaining the changes.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            feedback: {
+                type: "string",
+                description: "Optional feedback for regeneration (e.g., 'make the summary more technical')",
+            },
+        },
+        required: [],
+    },
+};
+// Input validation schema
+const OptimizeResumeInput = z.object({
+    feedback: z.string().optional(),
+});
+// Tool handler
+export async function handleOptimizeResume(args, apiUrl, apiKey) {
+    const input = OptimizeResumeInput.parse(args);
+    try {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (apiKey) {
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        }
+        const response = await fetch(`${apiUrl}/api/resumes/optimize`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                feedback: input.feedback,
+            }),
+        });
+        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 log in to JobSeek first:\n1. Visit https://jobseek-iota.vercel.app\n2. Sign in with Google\n3. Upload your resume\n4. Try this tool again",
+                        },
+                    ],
+                };
+            }
+            throw new Error(error.error || `API error: ${response.status}`);
+        }
+        const result = await response.json();
+        // Format the response nicely
+        const formattedResponse = `# ✨ ATS-Optimized Resume
+
+## Professional Summary
+${result.content.summary}
+
+## Skills
+${result.content.skills.map((s) => `- ${s}`).join("\n")}
+
+## Experience
+${result.content.experience
+            .map((exp) => `### ${exp.title} at ${exp.company}
+*${exp.duration}*
+
+${exp.description}`)
+            .join("\n\n")}
+
+## Education
+${result.content.education
+            .map((edu) => `- **${edu.degree}** - ${edu.institution} (${edu.year})`)
+            .join("\n")}
+
+---
+
+## 📋 Changes Made
+
+**Summary Changes:** ${result.rationale.summaryChanges}
+
+**Skill Prioritization:** ${result.rationale.skillPrioritization}
+
+**Experience Improvements:** ${result.rationale.experienceHighlights || result.rationale.experienceImprovements}
+
+**Formatting Changes:** ${result.rationale.formattingChanges}
+`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formattedResponse,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ **Error optimizing resume:** ${error.message}`,
+                },
+            ],
+        };
+    }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "jobseek-mcp",
+    "version": "0.1.0",
+    "description": "JobSeek MCP Server - AI-powered job search automation for Claude Code",
+    "author": "Shawn Mitchell",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/shawnmitchell/jobseek.git"
+    },
+    "keywords": [
+        "mcp",
+        "claude",
+        "ai",
+        "resume",
+        "job-search",
+        "ats",
+        "model-context-protocol"
+    ],
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "jobseek-mcp": "dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/index.ts",
+        "start": "node dist/index.js",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^0.6.0",
+        "zod": "^3.22.4"
+    },
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.3.0"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}