@leonailtd/priority-mcp-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LeonAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# Priority MCP Client
+
+MCP client for Priority ERP that connects Claude Desktop to a remote Priority MCP server.
+
+## Installation
+
+No installation required! Use with `npx`:
+
+```bash
+npx @leonailtd/priority-mcp-client --url https://priority-mcp.leonai.io --token sk-cust-xxx ...
+```
+
+## Usage
+
+### With Claude Desktop
+
+Add this configuration to your `claude_desktop_config.json`:
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Linux:** `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "priority-erp": {
+      "command": "npx",
+      "args": [
+        "@leonailtd/priority-mcp-client",
+        "--url",
+        "https://priority-mcp.leonai.io",
+        "--token",
+        "sk-cust-YOUR_API_KEY_HERE",
+        "--priority-url",
+        "https://your-company.priority-erp.com",
+        "--priority-company",
+        "YOUR_COMPANY_CODE",
+        "--priority-username",
+        "your_api_user",
+        "--priority-password",
+        "your_api_password"
+      ]
+    }
+  }
+}
+```
+
+### Command-Line Options
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `--url` | Yes | Priority MCP server URL (e.g., https://priority-mcp.leonai.io) |
+| `--token` | Yes | Authentication token from tenant provisioning (sk-cust-...) |
+| `--priority-url` | Yes | Your Priority ERP base URL |
+| `--priority-company` | Yes | Your company code in Priority |
+| `--priority-username` | Yes | Priority API username |
+| `--priority-password` | Yes | Priority API password |
+| `--debug` | No | Enable debug logging to stderr |
+
+### Getting Your API Token
+
+Contact your Priority MCP administrator to provision a tenant and receive your API key.
+
+## How It Works
+
+This client acts as a proxy between Claude Desktop (stdio transport) and the remote Priority MCP server (HTTP/SSE transport):
+
+```
+Claude Desktop (stdio)
+    ↓
+Priority MCP Client (this package)
+    ↓
+Remote Priority MCP Server (HTTP/SSE)
+    ↓
+Priority ERP API
+```
+
+## Features
+
+- ✅ No installation required (uses npx)
+- ✅ Works with Claude Desktop out of the box
+- ✅ Secure authentication with API keys
+- ✅ Supports all MCP protocol features (tools, resources, prompts)
+- ✅ Debug logging available
+- ✅ Cross-platform (Windows, macOS, Linux)
+
+## Troubleshooting
+
+### Connection Errors
+
+If you see connection errors:
+
+1. Verify the `--url` is correct
+2. Check your `--token` is valid
+3. Ensure Priority credentials are correct
+4. Try with `--debug` flag to see detailed logs
+
+### stdio Communication Errors
+
+If Claude Desktop can't connect:
+
+1. Restart Claude Desktop completely
+2. Verify the config file syntax (valid JSON)
+3. Check Node.js is installed (`node --version`)
+
+### Authentication Errors
+
+If you get 401/403 errors:
+
+1. Verify your API key is active (not expired/revoked)
+2. Check Priority credentials work directly in Priority
+3. Confirm Priority URL is accessible
+
+## Support
+
+For issues or questions:
+
+- GitHub: https://github.com/LeonAIcoil/priority-mcp-client
+- Email: support@leonai.io
+
+## License
+
+MIT License - see LICENSE file for details

package/dist/bin.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { program } from "commander";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+program.name("priority-mcp-client").description("MCP client that proxies Claude Desktop to Priority MCP server").requiredOption("--url <url>", "Priority MCP server URL (e.g., https://priority-mcp.leonai.io)").requiredOption("--token <token>", "Authentication token (sk-cust-...)").requiredOption("--priority-url <url>", "Priority ERP base URL").requiredOption("--priority-company <company>", "Priority company name").requiredOption("--priority-username <username>", "Priority API username").requiredOption("--priority-password <password>", "Priority API password").option("--debug", "Enable debug logging").parse();
+var options = program.opts();
+async function main() {
+  try {
+    const debug = options.debug || false;
+    if (debug) {
+      console.error("[DEBUG] Starting Priority MCP Client");
+      console.error(`[DEBUG] Connecting to: ${options.url}`);
+    }
+    const client = new Client({
+      name: "priority-mcp-client",
+      version: "1.0.0"
+    }, {
+      capabilities: {}
+    });
+    const headers = {
+      "Authorization": `Bearer ${options.token}`,
+      "X-Priority-URL": options.priorityUrl,
+      "X-Priority-Company": options.priorityCompany,
+      "X-Priority-Username": options.priorityUsername,
+      "X-Priority-Password": options.priorityPassword
+    };
+    if (debug) {
+      console.error("[DEBUG] Headers prepared (credentials hidden)");
+    }
+    const mcpUrl = new URL("/mcp", options.url);
+    const transport = new StreamableHTTPClientTransport(mcpUrl, {
+      requestInit: {
+        headers
+      }
+    });
+    await client.connect(transport);
+    if (debug) {
+      console.error("[DEBUG] Connected to remote Priority MCP server");
+    }
+    const server = new Server({
+      name: "priority-mcp-proxy",
+      version: "1.0.0"
+    }, {
+      capabilities: {
+        tools: {},
+        resources: {},
+        prompts: {}
+      }
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+      if (debug) console.error("[DEBUG] Forwarding tools/list");
+      const result = await client.listTools();
+      return result;
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      if (debug) console.error(`[DEBUG] Forwarding tools/call: ${request.params.name}`);
+      const result = await client.callTool(request.params);
+      return result;
+    });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+      if (debug) console.error("[DEBUG] Forwarding resources/list");
+      const result = await client.listResources();
+      return result;
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+      if (debug) console.error(`[DEBUG] Forwarding resources/read: ${request.params.uri}`);
+      const result = await client.readResource(request.params);
+      return result;
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+      if (debug) console.error("[DEBUG] Forwarding prompts/list");
+      const result = await client.listPrompts();
+      return result;
+    });
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+      if (debug) console.error(`[DEBUG] Forwarding prompts/get: ${request.params.name}`);
+      const result = await client.getPrompt(request.params);
+      return result;
+    });
+    const stdioTransport = new StdioServerTransport();
+    await server.connect(stdioTransport);
+    if (debug) {
+      console.error("[DEBUG] Stdio server ready, proxy active");
+    }
+    process.on("SIGINT", async () => {
+      if (debug) console.error("[DEBUG] Shutting down...");
+      await server.close();
+      await client.close();
+      process.exit(0);
+    });
+  } catch (error) {
+    console.error("Failed to start Priority MCP client:", error);
+    process.exit(1);
+  }
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\r\n\r\nimport { program } from 'commander';\r\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\r\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\r\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\r\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\r\nimport {\r\n  ListToolsRequestSchema,\r\n  CallToolRequestSchema,\r\n  ListResourcesRequestSchema,\r\n  ReadResourceRequestSchema,\r\n  ListPromptsRequestSchema,\r\n  GetPromptRequestSchema\r\n} from '@modelcontextprotocol/sdk/types.js';\r\n\r\n// Parse command-line arguments\r\nprogram\r\n  .name('priority-mcp-client')\r\n  .description('MCP client that proxies Claude Desktop to Priority MCP server')\r\n  .requiredOption('--url <url>', 'Priority MCP server URL (e.g., https://priority-mcp.leonai.io)')\r\n  .requiredOption('--token <token>', 'Authentication token (sk-cust-...)')\r\n  .requiredOption('--priority-url <url>', 'Priority ERP base URL')\r\n  .requiredOption('--priority-company <company>', 'Priority company name')\r\n  .requiredOption('--priority-username <username>', 'Priority API username')\r\n  .requiredOption('--priority-password <password>', 'Priority API password')\r\n  .option('--debug', 'Enable debug logging')\r\n  .parse();\r\n\r\nconst options = program.opts();\r\n\r\nasync function main() {\r\n  try {\r\n    const debug = options.debug || false;\r\n\r\n    if (debug) {\r\n      console.error('[DEBUG] Starting Priority MCP Client');\r\n      console.error(`[DEBUG] Connecting to: ${options.url}`);\r\n    }\r\n\r\n    // Create MCP client that will connect to remote Priority server\r\n    const client = new Client({\r\n      name: 'priority-mcp-client',\r\n      version: '1.0.0'\r\n    }, {\r\n      capabilities: {}\r\n    });\r\n\r\n    // Prepare headers for authentication\r\n    const headers = {\r\n      'Authorization': `Bearer ${options.token}`,\r\n      'X-Priority-URL': options.priorityUrl,\r\n      'X-Priority-Company': options.priorityCompany,\r\n      'X-Priority-Username': options.priorityUsername,\r\n      'X-Priority-Password': options.priorityPassword\r\n    };\r\n\r\n    if (debug) {\r\n      console.error('[DEBUG] Headers prepared (credentials hidden)');\r\n    }\r\n\r\n    // Connect to remote Priority MCP server via Streamable HTTP\r\n    const mcpUrl = new URL('/mcp', options.url);\r\n    const transport = new StreamableHTTPClientTransport(mcpUrl, {\r\n      requestInit: {\r\n        headers: headers\r\n      }\r\n    });\r\n\r\n    await client.connect(transport);\r\n\r\n    if (debug) {\r\n      console.error('[DEBUG] Connected to remote Priority MCP server');\r\n    }\r\n\r\n    // Create stdio server for Claude Desktop\r\n    const server = new Server({\r\n      name: 'priority-mcp-proxy',\r\n      version: '1.0.0'\r\n    }, {\r\n      capabilities: {\r\n        tools: {},\r\n        resources: {},\r\n        prompts: {}\r\n      }\r\n    });\r\n\r\n    // Set up request handlers that forward everything to the remote client\r\n\r\n    // List tools\r\n    server.setRequestHandler(ListToolsRequestSchema, async () => {\r\n      if (debug) console.error('[DEBUG] Forwarding tools/list');\r\n      const result = await client.listTools();\r\n      return result;\r\n    });\r\n\r\n    // Call tool\r\n    server.setRequestHandler(CallToolRequestSchema, async (request) => {\r\n      if (debug) console.error(`[DEBUG] Forwarding tools/call: ${request.params.name}`);\r\n      const result = await client.callTool(request.params);\r\n      return result;\r\n    });\r\n\r\n    // List resources\r\n    server.setRequestHandler(ListResourcesRequestSchema, async () => {\r\n      if (debug) console.error('[DEBUG] Forwarding resources/list');\r\n      const result = await client.listResources();\r\n      return result;\r\n    });\r\n\r\n    // Read resource\r\n    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\r\n      if (debug) console.error(`[DEBUG] Forwarding resources/read: ${request.params.uri}`);\r\n      const result = await client.readResource(request.params);\r\n      return result;\r\n    });\r\n\r\n    // List prompts\r\n    server.setRequestHandler(ListPromptsRequestSchema, async () => {\r\n      if (debug) console.error('[DEBUG] Forwarding prompts/list');\r\n      const result = await client.listPrompts();\r\n      return result;\r\n    });\r\n\r\n    // Get prompt\r\n    server.setRequestHandler(GetPromptRequestSchema, async (request) => {\r\n      if (debug) console.error(`[DEBUG] Forwarding prompts/get: ${request.params.name}`);\r\n      const result = await client.getPrompt(request.params);\r\n      return result;\r\n    });\r\n\r\n    // Connect server to stdio for Claude Desktop\r\n    const stdioTransport = new StdioServerTransport();\r\n    await server.connect(stdioTransport);\r\n\r\n    if (debug) {\r\n      console.error('[DEBUG] Stdio server ready, proxy active');\r\n    }\r\n\r\n    // Keep process running\r\n    process.on('SIGINT', async () => {\r\n      if (debug) console.error('[DEBUG] Shutting down...');\r\n      await server.close();\r\n      await client.close();\r\n      process.exit(0);\r\n    });\r\n\r\n  } catch (error) {\r\n    console.error('Failed to start Priority MCP client:', error);\r\n    process.exit(1);\r\n  }\r\n}\r\n\r\nmain().catch((error) => {\r\n  console.error('Fatal error:', error);\r\n  process.exit(1);\r\n});\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@leonailtd/priority-mcp-client",
+  "version": "0.1.0",
+  "description": "MCP client for Priority ERP - connects Claude Desktop to remote Priority MCP server",
+  "type": "module",
+  "main": "./dist/bin.js",
+  "bin": {
+    "priority-mcp-client": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "priority-erp",
+    "claude",
+    "proxy",
+    "stdio",
+    "http",
+    "sse"
+  ],
+  "author": "LeonAI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeonAIcoil/priority-mcp-client.git"
+  },
+  "homepage": "https://github.com/LeonAIcoil/priority-mcp-client#readme",
+  "bugs": {
+    "url": "https://github.com/LeonAIcoil/priority-mcp-client/issues",
+    "email": "support@leonai.io"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}