@teamnetwork-nz/payhero-mcp-server 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -44,7 +44,7 @@ Set the required environment variables in your MCP client configuration (the ser
44
44
  "mcpServers": {
45
45
  "payhero": {
46
46
  "command": "node",
47
- "args": ["C:/Users/daryl/Development/PayHero-MCP/dist/index.js"],
47
+ "args": ["C:/path/to/PayHero-MCP/dist/index.js"],
48
48
  "env": {
49
49
  "PAYHERO_CLIENT_ID": "...",
50
50
  "PAYHERO_CLIENT_SECRET": "...",
@@ -66,7 +66,7 @@ $env:PAYHERO_HTTP_PORT='3000'
66
66
  node dist/index.js
67
67
  ```
68
68
 
69
- The MCP endpoint is `POST /mcp`; `GET /health` is available for probes. Loopback binding is the default. Binding to a non-loopback address requires both `PAYHERO_HTTP_BEARER_TOKEN` and `PAYHERO_HTTP_ALLOWED_HOSTS`. Set `PAYHERO_HTTP_ALLOWED_ORIGINS` when browser clients need CORS-origin validation.
69
+ The MCP endpoint is `POST /mcp`; `GET /health` is available for probes. Loopback binding is the default. Binding to a non-loopback address requires both `PAYHERO_HTTP_BEARER_TOKEN` and `PAYHERO_HTTP_ALLOWED_HOSTS`. Set `PAYHERO_HTTP_ALLOWED_ORIGINS` when browser clients need CORS-origin validation. `PAYHERO_HTTP_MAX_BODY_BYTES` is a positive integer with a 1,048,576-byte default and 16,777,216-byte maximum.
70
70
 
71
71
  ## Important data-handling notes
72
72
 
package/dist/config.d.ts CHANGED
@@ -1,10 +1,26 @@
1
- export interface PayHeroConfig {
1
+ import { z } from 'zod';
2
+ export declare const PayHeroConfigSchema: z.ZodObject<{
3
+ clientId: z.ZodString;
4
+ clientSecret: z.ZodString;
5
+ companyCode: z.ZodOptional<z.ZodString>;
6
+ authUrl: z.ZodString;
7
+ apiUrl: z.ZodString;
8
+ readWrite: z.ZodBoolean;
9
+ }, "strict", z.ZodTypeAny, {
2
10
  clientId: string;
3
11
  clientSecret: string;
4
- companyCode?: string;
5
12
  authUrl: string;
6
13
  apiUrl: string;
7
14
  readWrite: boolean;
8
- }
15
+ companyCode?: string | undefined;
16
+ }, {
17
+ clientId: string;
18
+ clientSecret: string;
19
+ authUrl: string;
20
+ apiUrl: string;
21
+ readWrite: boolean;
22
+ companyCode?: string | undefined;
23
+ }>;
24
+ export type PayHeroConfig = z.infer<typeof PayHeroConfigSchema>;
9
25
  export declare function loadConfig(): PayHeroConfig;
10
26
  //# sourceMappingURL=config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;CACrD;AAID,wBAAgB,UAAU,IAAI,aAAa,CAY1C"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAOrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,wBAAgB,UAAU,IAAI,aAAa,CAY1C"}
package/dist/config.js CHANGED
@@ -1,3 +1,12 @@
1
+ import { z } from 'zod';
2
+ export const PayHeroConfigSchema = z.object({
3
+ clientId: z.string().min(1),
4
+ clientSecret: z.string().min(1),
5
+ companyCode: z.string().min(1).optional(),
6
+ authUrl: z.string().url(),
7
+ apiUrl: z.string().url(),
8
+ readWrite: z.boolean(),
9
+ }).strict();
1
10
  const cleanUrl = (value) => value.replace(/\/+$/, '');
2
11
  export function loadConfig() {
3
12
  const clientId = process.env.PAYHERO_CLIENT_ID?.trim();
@@ -6,12 +15,12 @@ export function loadConfig() {
6
15
  throw new Error('Missing required environment variable: PAYHERO_CLIENT_ID');
7
16
  if (!clientSecret)
8
17
  throw new Error('Missing required environment variable: PAYHERO_CLIENT_SECRET');
9
- return {
18
+ return PayHeroConfigSchema.parse({
10
19
  clientId, clientSecret,
11
20
  companyCode: process.env.PAYHERO_COMPANY_CODE?.trim() || undefined,
12
21
  authUrl: cleanUrl(process.env.PAYHERO_AUTH_URL?.trim() || 'https://publicapi.payhero.co.nz/oauth/v1/token'),
13
22
  apiUrl: cleanUrl(process.env.PAYHERO_API_URL?.trim() || 'https://publicapi.payhero.co.nz/v1'),
14
23
  readWrite: process.env.PAYHERO_READWRITE?.toLowerCase() === 'true',
15
- };
24
+ });
16
25
  }
17
26
  //# sourceMappingURL=config.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9D,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC3F,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACnG,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,SAAS;QAClE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gDAAgD,CAAC;QAC3G,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,oCAAoC,CAAC;QAC7F,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,KAAK,MAAM;KACnE,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE9D,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC3F,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACnG,OAAO,mBAAmB,CAAC,KAAK,CAAC;QAC/B,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,SAAS;QAClE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gDAAgD,CAAC;QAC3G,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,oCAAoC,CAAC;QAC7F,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,KAAK,MAAM;KACnE,CAAC,CAAC;AACL,CAAC"}
package/dist/env.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ export declare function parsePositiveInt(name: string, raw: string | undefined, fallback: number, maximum: number): number;
2
+ //# sourceMappingURL=env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMjH"}
package/dist/env.js ADDED
@@ -0,0 +1,8 @@
1
+ export function parsePositiveInt(name, raw, fallback, maximum) {
2
+ const value = raw === undefined || raw === '' ? fallback : Number(raw);
3
+ if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
4
+ throw new Error(`${name} must be a positive integer no greater than ${maximum}`);
5
+ }
6
+ return value;
7
+ }
8
+ //# sourceMappingURL=env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,GAAuB,EAAE,QAAgB,EAAE,OAAe;IACvG,MAAM,KAAK,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,+CAA+C,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import http from 'node:http';
2
- interface Connectable {
2
+ export interface McpConnectable {
3
3
  connect(transport: any): Promise<void>;
4
4
  close(): Promise<void>;
5
5
  }
@@ -10,8 +10,8 @@ export interface HttpOptions {
10
10
  bearerToken?: string;
11
11
  allowedHosts?: string[];
12
12
  allowedOrigins?: string[];
13
+ maxBodyBytes?: number;
13
14
  }
14
- export declare function validateHttpOptions(o: HttpOptions): void;
15
- export declare function createHttpServer(factory: () => Connectable, o: HttpOptions): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
16
- export {};
15
+ export declare function validateHttpOptions(options: HttpOptions): void;
16
+ export declare function createHttpServer(factory: () => McpConnectable, options: HttpOptions): http.Server;
17
17
  //# sourceMappingURL=http-server.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,UAAU,WAAW;IAAG,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;AACxF,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AAEzJ,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,WAAW,QAAoX;AAGta,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,WAAW,EAAE,CAAC,EAAE,WAAW,wEAA2yC"}
1
+ {"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2CD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAgB9D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,CA4CjG"}
@@ -2,29 +2,102 @@ import { timingSafeEqual } from 'node:crypto';
2
2
  import http from 'node:http';
3
3
  import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
4
4
  const loopback = new Set(['127.0.0.1', '::1', 'localhost']);
5
- export function validateHttpOptions(o) { if (!Number.isInteger(o.port) || o.port < 1 || o.port > 65535)
6
- throw new Error(`Invalid HTTP port: ${o.port}`); if (!loopback.has(o.host) && !o.bearerToken)
7
- throw new Error('A bearer token is required when binding beyond loopback'); if (!loopback.has(o.host) && !o.allowedHosts?.length)
8
- throw new Error('HTTP_ALLOWED_HOSTS is required when binding beyond loopback'); }
9
- const send = (res, status, body) => res.writeHead(status, { 'content-type': 'application/json' }).end(JSON.stringify(body));
10
- const authOk = (header, expected) => { if (!header?.startsWith('Bearer '))
11
- return false; const a = Buffer.from(header.slice(7)), b = Buffer.from(expected); return a.length === b.length && timingSafeEqual(a, b); };
12
- export function createHttpServer(factory, o) { validateHttpOptions(o); const hosts = new Set(o.allowedHosts?.map(v => v.toLowerCase())); const origins = new Set(o.allowedOrigins?.map(v => v.toLowerCase())); return http.createServer(async (req, res) => { const path = new URL(req.url ?? '/', 'http://localhost').pathname; if (path === '/health')
13
- return send(res, 200, { status: 'ok', server: o.serverName }); if (path !== '/mcp')
14
- return void res.writeHead(404).end(); if (hosts.size && !hosts.has((req.headers.host ?? '').toLowerCase()))
15
- return send(res, 403, { error: 'Host not allowed' }); if (req.headers.origin && !origins.has(req.headers.origin.toLowerCase()))
16
- return send(res, 403, { error: 'Origin not allowed' }); if (o.bearerToken && !authOk(req.headers.authorization, o.bearerToken))
17
- return send(res, 401, { error: 'Unauthorized' }); if (req.method !== 'POST')
18
- return send(res, 405, { error: 'Method not allowed' }); const chunks = []; for await (const c of req)
19
- chunks.push(c); const server = factory(), transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined }); try {
20
- await server.connect(transport);
21
- await transport.handleRequest(req, res, JSON.parse(Buffer.concat(chunks).toString('utf8')));
5
+ const send = (res, status, body) => {
6
+ res.writeHead(status, { 'content-type': 'application/json' }).end(JSON.stringify(body));
7
+ };
8
+ const sendError = (res, status, code, message) => {
9
+ send(res, status, { jsonrpc: '2.0', error: { code, message }, id: null });
10
+ };
11
+ const matchesBearer = (value, expected) => {
12
+ if (!value?.startsWith('Bearer '))
13
+ return false;
14
+ const supplied = Buffer.from(value.slice(7));
15
+ const wanted = Buffer.from(expected);
16
+ return supplied.length === wanted.length && timingSafeEqual(supplied, wanted);
17
+ };
18
+ const readBody = (req, limit) => new Promise((resolve, reject) => {
19
+ const chunks = [];
20
+ let size = 0;
21
+ let oversized = false;
22
+ req.on('data', (chunk) => {
23
+ size += chunk.length;
24
+ oversized ||= size > limit;
25
+ if (!oversized)
26
+ chunks.push(chunk);
27
+ });
28
+ req.on('end', () => {
29
+ if (oversized) {
30
+ reject(Object.assign(new Error('Request body too large'), { statusCode: 413 }));
31
+ return;
32
+ }
33
+ try {
34
+ resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')));
35
+ }
36
+ catch {
37
+ reject(Object.assign(new Error('Invalid JSON body'), { statusCode: 400 }));
38
+ }
39
+ });
40
+ req.on('error', reject);
41
+ });
42
+ export function validateHttpOptions(options) {
43
+ if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65_535) {
44
+ throw new Error(`Invalid HTTP port: ${options.port}`);
45
+ }
46
+ if (options.maxBodyBytes !== undefined &&
47
+ (!Number.isInteger(options.maxBodyBytes) || options.maxBodyBytes < 1)) {
48
+ throw new Error(`Invalid HTTP body limit: ${options.maxBodyBytes}`);
49
+ }
50
+ if (!loopback.has(options.host) && !options.bearerToken) {
51
+ throw new Error('A bearer token is required when binding beyond loopback');
52
+ }
53
+ if (!loopback.has(options.host) && !options.allowedHosts?.length) {
54
+ throw new Error('HTTP_ALLOWED_HOSTS is required when binding beyond loopback');
55
+ }
22
56
  }
23
- catch (e) {
24
- if (!res.headersSent)
25
- send(res, 500, { error: e instanceof Error ? e.message : String(e) });
57
+ export function createHttpServer(factory, options) {
58
+ validateHttpOptions(options);
59
+ const hosts = new Set(options.allowedHosts?.map((value) => value.toLowerCase()));
60
+ const origins = new Set(options.allowedOrigins?.map((value) => value.toLowerCase()));
61
+ return http.createServer(async (req, res) => {
62
+ const path = new URL(req.url ?? '/', 'http://localhost').pathname;
63
+ if (path === '/health')
64
+ return send(res, 200, { status: 'ok', server: options.serverName });
65
+ if (path !== '/mcp')
66
+ return void res.writeHead(404).end();
67
+ if (hosts.size && !hosts.has((req.headers.host ?? '').toLowerCase())) {
68
+ return sendError(res, 403, -32000, 'Host not allowed');
69
+ }
70
+ if (req.headers.origin && !origins.has(req.headers.origin.toLowerCase())) {
71
+ return sendError(res, 403, -32000, 'Origin not allowed');
72
+ }
73
+ if (options.bearerToken && !matchesBearer(req.headers.authorization, options.bearerToken)) {
74
+ res.setHeader('WWW-Authenticate', 'Bearer');
75
+ return sendError(res, 401, -32001, 'Unauthorized');
76
+ }
77
+ if (req.method !== 'POST') {
78
+ res.setHeader('Allow', 'POST');
79
+ return sendError(res, 405, -32000, 'Method not allowed');
80
+ }
81
+ const server = factory();
82
+ const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
83
+ try {
84
+ const body = await readBody(req, options.maxBodyBytes ?? 1_048_576);
85
+ await server.connect(transport);
86
+ await transport.handleRequest(req, res, body);
87
+ res.once('close', () => {
88
+ void transport.close();
89
+ void server.close();
90
+ });
91
+ }
92
+ catch (cause) {
93
+ void transport.close();
94
+ void server.close();
95
+ if (!res.headersSent) {
96
+ const status = cause.statusCode ?? 500;
97
+ const message = status < 500 ? cause.message : 'Internal server error';
98
+ sendError(res, status, status === 400 ? -32700 : -32603, message);
99
+ }
100
+ }
101
+ });
26
102
  }
27
- finally {
28
- res.once('close', () => { void transport.close(); void server.close(); });
29
- } }); }
30
103
  //# sourceMappingURL=http-server.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -1,27 +1,47 @@
1
1
  #!/usr/bin/env node
2
- import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
- import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
5
- import { zodToJsonSchema } from 'zod-to-json-schema';
6
4
  import { loadConfig } from './config.js';
7
5
  import { PayHeroClient } from './client.js';
8
6
  import { makeTools } from './tools.js';
9
7
  import { createHttpServer } from './http-server.js';
10
- const config = loadConfig(), client = new PayHeroClient(config), tools = makeTools(client, config.readWrite);
11
- const factory = () => { const server = new Server({ name: 'payhero-mcp-server', version: '0.1.0' }, { capabilities: { tools: {} }, instructions: 'PayHero payroll API MCP. Read-only by default. Call payhero_connect first to verify authentication/company selection. Dates use PayHero formats documented per endpoint. Write tools appear only when PAYHERO_READWRITE=true. Employee pay/bank/tax and payroll data are sensitive; disclose minimally.' }); server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools.map(t => ({ name: t.name, description: t.description, inputSchema: zodToJsonSchema(t.inputSchema) })) })); server.setRequestHandler(CallToolRequestSchema, async (req) => { const tool = tools.find(t => t.name === req.params.name); if (!tool)
12
- return { isError: true, content: [{ type: 'text', text: `Unknown or disabled tool: ${req.params.name}` }] }; try {
13
- const args = tool.inputSchema.parse(req.params.arguments ?? {});
14
- const result = await tool.handler(args);
15
- return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
16
- }
17
- catch (e) {
18
- return { isError: true, content: [{ type: 'text', text: e instanceof Error ? e.message : String(e) }] };
19
- } }); return server; };
8
+ import { parsePositiveInt } from './env.js';
9
+ import { packageName, packageVersion } from './package-info.js';
10
+ const config = loadConfig();
11
+ const client = new PayHeroClient(config);
12
+ const tools = makeTools(client, config.readWrite);
13
+ const factory = () => {
14
+ const server = new McpServer({ name: packageName, version: packageVersion }, {
15
+ instructions: 'PayHero payroll API MCP. Read-only by default. Call payhero_connect first to verify authentication/company selection. Dates use PayHero formats documented per endpoint. Write tools appear only when PAYHERO_READWRITE=true. Employee pay/bank/tax and payroll data are sensitive; disclose minimally.',
16
+ });
17
+ for (const tool of tools) {
18
+ server.registerTool(tool.name, { description: tool.description, inputSchema: tool.inputSchema.strict() }, async (args) => {
19
+ try {
20
+ const result = await tool.handler(args);
21
+ return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
22
+ }
23
+ catch (error) {
24
+ return { isError: true, content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }] };
25
+ }
26
+ });
27
+ }
28
+ return server;
29
+ };
20
30
  if ((process.env.PAYHERO_TRANSPORT ?? 'stdio') === 'http') {
21
- const host = process.env.PAYHERO_HTTP_HOST ?? '127.0.0.1', port = Number.parseInt(process.env.PAYHERO_HTTP_PORT ?? '3000', 10);
22
- createHttpServer(factory, { host, port, serverName: 'payhero-mcp-server', bearerToken: process.env.PAYHERO_HTTP_BEARER_TOKEN, allowedHosts: process.env.PAYHERO_HTTP_ALLOWED_HOSTS?.split(',').map(v => v.trim()).filter(Boolean), allowedOrigins: process.env.PAYHERO_HTTP_ALLOWED_ORIGINS?.split(',').map(v => v.trim()).filter(Boolean) }).listen(port, host);
31
+ const host = process.env.PAYHERO_HTTP_HOST ?? '127.0.0.1';
32
+ const port = parsePositiveInt('PAYHERO_HTTP_PORT', process.env.PAYHERO_HTTP_PORT, 3000, 65535);
33
+ createHttpServer(factory, {
34
+ host,
35
+ port,
36
+ serverName: packageName,
37
+ bearerToken: process.env.PAYHERO_HTTP_BEARER_TOKEN,
38
+ allowedHosts: process.env.PAYHERO_HTTP_ALLOWED_HOSTS?.split(',').map((value) => value.trim()).filter(Boolean),
39
+ allowedOrigins: process.env.PAYHERO_HTTP_ALLOWED_ORIGINS?.split(',').map((value) => value.trim()).filter(Boolean),
40
+ maxBodyBytes: parsePositiveInt('PAYHERO_HTTP_MAX_BODY_BYTES', process.env.PAYHERO_HTTP_MAX_BODY_BYTES, 1_048_576, 16_777_216),
41
+ }).listen(port, host);
23
42
  }
24
- else
43
+ else {
25
44
  await factory().connect(new StdioServerTransport());
45
+ }
26
46
  process.stderr.write(`PayHero MCP started: ${tools.length} tools (${config.readWrite ? 'read-write' : 'read-only'})\n`);
27
47
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export declare const packageName: string;
2
+ export declare const packageVersion: string;
3
+ //# sourceMappingURL=package-info.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"package-info.d.ts","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,QAA2C,CAAC;AACpE,eAAO,MAAM,cAAc,QAAiC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { dirname, join } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ const packageJson = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
5
+ export const packageName = packageJson.name ?? 'payhero-mcp-server';
6
+ export const packageVersion = packageJson.version ?? '0.0.0';
7
+ //# sourceMappingURL=package-info.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"package-info.js","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAwC,CAAC;AACjK,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,IAAI,oBAAoB,CAAC;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC"}
package/package.json CHANGED
@@ -1,10 +1,12 @@
1
1
  {
2
2
  "name": "@teamnetwork-nz/payhero-mcp-server",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "MCP server for the PayHero payroll API",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
- "bin": { "payhero-mcp-server": "dist/index.js" },
7
+ "bin": {
8
+ "payhero-mcp-server": "dist/index.js"
9
+ },
8
10
  "scripts": {
9
11
  "build": "tsc",
10
12
  "dev": "tsx src/index.ts",
@@ -12,12 +14,14 @@
12
14
  "smoke": "npm run build && node scripts/smoke-test.mjs",
13
15
  "smoke:mcp": "npm run build && node scripts/mcp-protocol-test.mjs"
14
16
  },
15
- "files": ["dist"],
17
+ "files": [
18
+ "dist"
19
+ ],
16
20
  "license": "MIT",
17
21
  "dependencies": {
18
- "@modelcontextprotocol/sdk": "^1.10.0",
22
+ "@modelcontextprotocol/sdk": "^1.29.0",
19
23
  "axios": "^1.7.0",
20
- "zod": "^3.23.0",
24
+ "zod": "^3.25.0",
21
25
  "zod-to-json-schema": "^3.25.2"
22
26
  },
23
27
  "devDependencies": {
@@ -25,5 +29,7 @@
25
29
  "tsx": "^4.15.0",
26
30
  "typescript": "^5.5.0"
27
31
  },
28
- "engines": { "node": ">=20.0.0" }
32
+ "engines": {
33
+ "node": ">=20.0.0"
34
+ }
29
35
  }