@thenextgennexus/hr-compensation-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,73 @@
+# HR & Compensation MCP Server
+
+Search H1B visa salaries, salary benchmarks, and job market data — powered by [nexgendata](https://apify.com/nexgendata) on Apify.
+
+## Quick Start
+
+### Using npx (recommended)
+
+```bash
+npx @nexgendata/hr-compensation-mcp-server
+```
+
+### Install globally
+
+```bash
+npm install -g @nexgendata/hr-compensation-mcp-server
+```
+
+## Configure with Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+      "mcpServers": {
+            "hr-compensation-mcp-server": {
+                  "command": "npx",
+                  "args": [
+                        "-y",
+                        "@nexgendata/hr-compensation-mcp-server"
+                  ],
+                  "env": {
+                        "APIFY_TOKEN": "your-apify-token-optional"
+                  }
+            }
+      }
+}
+```
+
+## Configure with Cline
+
+Add the same configuration to your Cline MCP settings.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_h1b_salaries` | Search H1B visa salary data by employer, job title, or location |
+| `get_salary_benchmarks` | Get salary benchmark data for roles and locations |
+| `analyze_compensation` | Analyze compensation trends for a role or company |
+| `search_job_market` | Search current job market data and trends |
+| `get_company_salary_data` | Get salary data for a specific company |
+
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `APIFY_TOKEN` | No | Your Apify API token for authenticated access. Without it, the server uses the public endpoint (rate-limited). |
+
+## How It Works
+
+This MCP server acts as a local stdio bridge to the [nexgendata Apify MCP endpoint](https://nexgendata--hr-compensation-mcp-server.apify.actor/mcp). When you call a tool, it forwards the request to Apify and returns the results.
+
+## Links
+
+- [Apify Store](https://apify.com/nexgendata/hr-compensation-mcp-server)
+- [GitHub Repository](https://github.com/TheNextGenNexus/business-data-mcp-servers)
+- [nexgendata Blog](https://thenextgennexus.com)
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const APIFY_ENDPOINT = "https://nexgendata--hr-compensation-mcp-server.apify.actor/mcp";
+const APIFY_TOKEN = process.env.APIFY_TOKEN || "";
+async function callApifyTool(toolName, args) {
+    const url = new URL(APIFY_ENDPOINT);
+    if (APIFY_TOKEN) {
+        url.searchParams.set("token", APIFY_TOKEN);
+    }
+    const body = {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+            name: toolName,
+            arguments: args
+        }
+    };
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Apify API error (${response.status}): ${errorText}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+        throw new Error(`Tool error: ${JSON.stringify(data.error)}`);
+    }
+    // Extract text content from MCP response
+    const result = data.result;
+    if (result?.content && Array.isArray(result.content)) {
+        return result.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("\n");
+    }
+    return JSON.stringify(data.result, null, 2);
+}
+const server = new McpServer({
+    name: "hr-compensation-mcp-server",
+    version: "1.0.0"
+});
+server.registerTool("search_h1b_salaries", {
+    title: "Search H1B Salaries",
+    description: "Search H1B visa salary data",
+    inputSchema: {
+        query: z.string().describe('Employer, job title, or location'),
+        year: z.number().optional().describe('Filing year'),
+        maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("search_h1b_salaries", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("get_salary_benchmarks", {
+    title: "Get Salary Benchmarks",
+    description: "Get salary benchmarks for roles",
+    inputSchema: {
+        jobTitle: z.string().describe('Job title'),
+        location: z.string().optional().describe('City or region'),
+        maxItems: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("get_salary_benchmarks", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("analyze_compensation", {
+    title: "Analyze Compensation",
+    description: "Analyze compensation trends",
+    inputSchema: {
+        query: z.string().describe('Company or role'),
+        maxItems: z.number().default(20).describe('Maximum data points')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("analyze_compensation", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("search_job_market", {
+    title: "Search Job Market",
+    description: "Search job market data and trends",
+    inputSchema: {
+        query: z.string().describe('Job market search query'),
+        maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("search_job_market", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+server.registerTool("get_company_salary_data", {
+    title: "Get Company Salary Data",
+    description: "Get salary data for a company",
+    inputSchema: {
+        company: z.string().describe('Company name'),
+        maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true
+    }
+}, async (args) => {
+    try {
+        const result = await callApifyTool("get_company_salary_data", args);
+        return {
+            content: [{ type: "text", text: result }]
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("HR & Compensation MCP Server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@thenextgennexus/hr-compensation-mcp-server",
+  "version": "1.0.0",
+  "description": "Search H1B visa salaries, salary benchmarks, and job market data",
+  "type": "module",
+  "bin": {
+    "hr-compensation-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "tsx": "^4.7.0",
+    "@types/node": "^20.11.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "apify",
+    "nexgendata"
+  ],
+  "author": "nexgendata",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TheNextGenNexus/business-data-mcp-servers"
+  },
+  "mcpName": "io.github.thenextgennexus/hr-compensation-mcp-server"
+}

package/smithery.yaml

@@ -0,0 +1,13 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    required:
+      - apifyToken
+    properties:
+      apifyToken:
+        type: string
+        description: Your Apify API token. Get one free at https://apify.com
+  commandFunction:
+    |-
+    (config) => ({{ command: 'npx', args: ['tsx', 'src/index.ts'], env: {{ APIFY_TOKEN: config.apifyToken }} }})

package/src/index.ts

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const APIFY_ENDPOINT = "https://nexgendata--hr-compensation-mcp-server.apify.actor/mcp";
+const APIFY_TOKEN = process.env.APIFY_TOKEN || "";
+
+async function callApifyTool(toolName: string, args: Record<string, unknown>): Promise<string> {
+  const url = new URL(APIFY_ENDPOINT);
+  if (APIFY_TOKEN) {
+    url.searchParams.set("token", APIFY_TOKEN);
+  }
+
+  const body = {
+    jsonrpc: "2.0",
+    id: 1,
+    method: "tools/call",
+    params: {
+      name: toolName,
+      arguments: args
+    }
+  };
+
+  const response = await fetch(url.toString(), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Apify API error (${response.status}): ${errorText}`);
+  }
+
+  const data = await response.json();
+
+  if (data.error) {
+    throw new Error(`Tool error: ${JSON.stringify(data.error)}`);
+  }
+
+  // Extract text content from MCP response
+  const result = data.result;
+  if (result?.content && Array.isArray(result.content)) {
+    return result.content
+      .filter((c: { type: string }) => c.type === "text")
+      .map((c: { text: string }) => c.text)
+      .join("\n");
+  }
+
+  return JSON.stringify(data.result, null, 2);
+}
+
+const server = new McpServer({
+  name: "hr-compensation-mcp-server",
+  version: "1.0.0"
+});
+
+server.registerTool(
+  "search_h1b_salaries",
+  {
+    title: "Search H1B Salaries",
+    description: "Search H1B visa salary data",
+    inputSchema: {
+      query: z.string().describe('Employer, job title, or location'),
+      year: z.number().optional().describe('Filing year'),
+      maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("search_h1b_salaries", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "get_salary_benchmarks",
+  {
+    title: "Get Salary Benchmarks",
+    description: "Get salary benchmarks for roles",
+    inputSchema: {
+      jobTitle: z.string().describe('Job title'),
+      location: z.string().optional().describe('City or region'),
+      maxItems: z.number().default(10).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("get_salary_benchmarks", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "analyze_compensation",
+  {
+    title: "Analyze Compensation",
+    description: "Analyze compensation trends",
+    inputSchema: {
+      query: z.string().describe('Company or role'),
+      maxItems: z.number().default(20).describe('Maximum data points')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("analyze_compensation", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "search_job_market",
+  {
+    title: "Search Job Market",
+    description: "Search job market data and trends",
+    inputSchema: {
+      query: z.string().describe('Job market search query'),
+      maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("search_job_market", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+server.registerTool(
+  "get_company_salary_data",
+  {
+    title: "Get Company Salary Data",
+    description: "Get salary data for a company",
+    inputSchema: {
+      company: z.string().describe('Company name'),
+      maxItems: z.number().default(20).describe('Maximum results')
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  async (args) => {
+    try {
+      const result = await callApifyTool("get_company_salary_data", args);
+      return {
+        content: [{ type: "text", text: result }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true
+      };
+    }
+  }
+);
+
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("HR & Compensation MCP Server running on stdio");
+}
+
+main().catch(console.error);

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}