@snokam/mcp-cvpartner 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# @snokam/mcp-cvpartner
+
+MCP (Model Context Protocol) server for CVPartner CV management. Enables AI agents to search and retrieve consultant CVs.
+
+## Features
+
+- 🔍 **Search CVs** by name, skills, or experience
+- 👥 **List consultants** with their profiles
+- 📄 **Get full CV content** in Norwegian or English
+- 🛠️ **Find consultants by skill** (React, Python, Azure, etc.)
+
+## Installation
+
+```bash
+cd mcp/@snokam/cvpartner
+pnpm install
+pnpm build
+```
+
+## Configuration
+
+```env
+CVPARTNER_API_KEY=your_api_key
+CVPARTNER_ORG=snokam  # Optional, defaults to "snokam"
+```
+
+## Usage with mcporter
+
+Add to your mcporter config:
+
+```json
+{
+  "mcpServers": {
+    "cvpartner": {
+      "command": "node",
+      "args": ["/path/to/mcp/@snokam/cvpartner/dist/index.js"],
+      "env": {
+        "CVPARTNER_ORG": "snokam"
+      }
+    }
+  }
+}
+```
+
+API key should be set in environment or fetched from 1Password.
+
+## Available Tools
+
+| Tool                        | Description                           |
+| --------------------------- | ------------------------------------- |
+| `list_users`                | List all consultants                  |
+| `search_cvs`                | Search CVs by any text                |
+| `get_user`                  | Get user profile details              |
+| `get_cv`                    | Get full CV content                   |
+| `find_consultants_by_skill` | Find consultants with specific skills |
+
+## API Documentation
+
+CVPartner API: https://docs.cvpartner.com/

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// Environment variables
+const API_KEY = process.env.CVPARTNER_API_KEY;
+const ORG = process.env.CVPARTNER_ORG || "snokam";
+const BASE_URL = `https://${ORG}.cvpartner.com/api`;
+async function cvpartnerFetch(endpoint, options = {}) {
+    if (!API_KEY) {
+        throw new Error("CVPARTNER_API_KEY environment variable is required");
+    }
+    const response = await fetch(`${BASE_URL}${endpoint}`, {
+        ...options,
+        headers: {
+            Authorization: `Token token=${API_KEY}`,
+            "Content-Type": "application/json",
+            ...options.headers,
+        },
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`CVPartner API error: ${response.status} - ${error || response.statusText}`);
+    }
+    return response.json();
+}
+const server = new McpServer({
+    name: "cvpartner-mcp",
+    version: "1.0.0",
+});
+// Tool: List all users/consultants
+server.tool("list_users", "List all users/consultants in CVPartner", {
+    include_deactivated: z
+        .boolean()
+        .default(false)
+        .describe("Include deactivated users"),
+}, async ({ include_deactivated }) => {
+    const users = await cvpartnerFetch("/v1/users");
+    const filtered = include_deactivated
+        ? users
+        : users.filter((u) => !u.deactivated);
+    const simplified = filtered.map((u) => ({
+        user_id: u.user_id,
+        name: u.name,
+        email: u.email,
+        title: u.title?.no || u.title?.int || null,
+        telephone: u.telephone,
+        office: u.office_name,
+        cv_id: u.default_cv_id,
+    }));
+    return {
+        content: [{ type: "text", text: JSON.stringify(simplified, null, 2) }],
+    };
+});
+// Tool: Search CVs
+server.tool("search_cvs", "Search CVs by name, skills, or experience", {
+    query: z.string().describe("Search query (name, skill, technology, etc.)"),
+    size: z.number().default(10).describe("Maximum number of results"),
+}, async ({ query, size }) => {
+    const response = await cvpartnerFetch("/v4/search", {
+        method: "POST",
+        body: JSON.stringify({ query, size }),
+    });
+    const results = response.cvs.map((r) => ({
+        user_id: r.cv.user_id,
+        name: r.cv.name,
+        email: r.cv.email,
+        title: r.cv.title || r.cv.titles?.no || r.cv.titles?.int,
+        telephone: r.cv.telephone,
+        highlight: r.highlight,
+    }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ total: response.total, results }, null, 2),
+            },
+        ],
+    };
+});
+// Tool: Get user details
+server.tool("get_user", "Get detailed information about a specific user", {
+    user_id: z.string().describe("User ID from CVPartner"),
+}, async ({ user_id }) => {
+    const user = await cvpartnerFetch(`/v1/users/${user_id}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(user, null, 2) }],
+    };
+});
+// Tool: Get CV details
+server.tool("get_cv", "Get full CV content for a user", {
+    user_id: z.string().describe("User ID"),
+    cv_id: z.string().describe("CV ID (from user's default_cv_id)"),
+    language: z
+        .enum(["no", "int"])
+        .default("no")
+        .describe("Language version (no=Norwegian, int=English)"),
+}, async ({ user_id, cv_id, language }) => {
+    const cv = await cvpartnerFetch(`/v4/cvs/${user_id}/${cv_id}/${language}`);
+    return {
+        content: [{ type: "text", text: JSON.stringify(cv, null, 2) }],
+    };
+});
+// Tool: Search by technology/skill
+server.tool("find_consultants_by_skill", "Find consultants with specific skills or technologies", {
+    skill: z
+        .string()
+        .describe("Skill or technology to search for (e.g., React, Python, Azure)"),
+    limit: z.number().default(10).describe("Maximum number of results"),
+}, async ({ skill, limit }) => {
+    const response = await cvpartnerFetch("/v4/search", {
+        method: "POST",
+        body: JSON.stringify({
+            query: skill,
+            size: limit,
+            filter_fields: ["technologies", "project_experiences"],
+        }),
+    });
+    const results = response.cvs
+        .filter((r) => !r.cv.is_deactivated)
+        .map((r) => ({
+        name: r.cv.name,
+        email: r.cv.email,
+        title: r.cv.title || r.cv.titles?.no,
+        match: r.highlight,
+    }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ skill, total: response.total, consultants: results }, null, 2),
+            },
+        ],
+    };
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[cvpartner-mcp] Server running on stdio");
+}
+main().catch((error) => {
+    console.error("[cvpartner-mcp] Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@snokam/mcp-cvpartner",
+  "version": "1.0.0",
+  "description": "MCP server for CVPartner CV management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "snokam-cvpartner-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}