@teamnetwork-nz/payhero-mcp-server 0.1.1 → 0.1.3
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 +1 -1
- package/dist/config.d.ts +19 -3
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +11 -2
- package/dist/config.js.map +1 -1
- package/dist/env.d.ts +2 -0
- package/dist/env.d.ts.map +1 -0
- package/dist/env.js +8 -0
- package/dist/env.js.map +1 -0
- package/dist/http-server.d.ts +4 -4
- package/dist/http-server.d.ts.map +1 -1
- package/dist/http-server.js +96 -23
- package/dist/http-server.js.map +1 -1
- package/dist/index.js +36 -16
- package/dist/index.js.map +1 -1
- package/dist/package-info.d.ts +3 -0
- package/dist/package-info.d.ts.map +1 -0
- package/dist/package-info.js +7 -0
- package/dist/package-info.js.map +1 -0
- package/dist/tools.d.ts +1 -1
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +1 -1
- package/dist/tools.js.map +1 -1
- package/package.json +35 -29
package/README.md
CHANGED
|
@@ -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
|
-
|
|
1
|
+
import { z } from 'zod/v3';
|
|
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
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,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/v3';
|
|
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
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,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 @@
|
|
|
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
|
package/dist/env.js.map
ADDED
|
@@ -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"}
|
package/dist/http-server.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import http from 'node:http';
|
|
2
|
-
interface
|
|
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(
|
|
15
|
-
export declare function createHttpServer(factory: () =>
|
|
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;
|
|
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"}
|
package/dist/http-server.js
CHANGED
|
@@ -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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
return
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
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
|
-
|
|
24
|
-
|
|
25
|
-
|
|
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
|
package/dist/http-server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;
|
|
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 {
|
|
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
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
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'
|
|
22
|
-
|
|
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":";AACA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -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/dist/tools.d.ts
CHANGED
package/dist/tools.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyC5C,eAAO,MAAM,SAAS,GAAI,QAAQ,aAAa,EAAE,WAAW,OAAO;;;;;;;;;;;;;;;;;;;;;iBAGuJ;QAAC,KAAK,EAAC,OAAO,CAAA;KAAC;;;;;;;;;;;;;;;;;;;;;;iBAMxN;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAC;IAGjE,CAAC"}
|
package/dist/tools.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { z } from 'zod';
|
|
1
|
+
import { z } from 'zod/v3';
|
|
2
2
|
const operations = [
|
|
3
3
|
['get_employee_info', 'GET', '/employee/info', 'Employee identity, contact, employment and work pattern', ['employee_key', 'load_finished']],
|
|
4
4
|
['get_employee_pay_info', 'GET', '/employee/pay_info', 'Employee tax, pay, bank and KiwiSaver settings', ['employee_key', 'load_finished']],
|
package/dist/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,29 +1,35 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@teamnetwork-nz/payhero-mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "MCP server for the PayHero payroll API",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"main": "dist/index.js",
|
|
7
|
-
"bin": {
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
"
|
|
18
|
-
"
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "@teamnetwork-nz/payhero-mcp-server",
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "MCP server for the PayHero payroll API",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "dist/index.js",
|
|
7
|
+
"bin": {
|
|
8
|
+
"payhero-mcp-server": "dist/index.js"
|
|
9
|
+
},
|
|
10
|
+
"scripts": {
|
|
11
|
+
"build": "tsc",
|
|
12
|
+
"dev": "tsx src/index.ts",
|
|
13
|
+
"test": "npm run build && node --test tests/*.test.mjs",
|
|
14
|
+
"smoke": "npm run build && node scripts/smoke-test.mjs",
|
|
15
|
+
"smoke:mcp": "npm run build && node scripts/mcp-protocol-test.mjs"
|
|
16
|
+
},
|
|
17
|
+
"files": [
|
|
18
|
+
"dist"
|
|
19
|
+
],
|
|
20
|
+
"license": "MIT",
|
|
21
|
+
"dependencies": {
|
|
22
|
+
"@modelcontextprotocol/sdk": "^1.32.2",
|
|
23
|
+
"axios": "^1.7.0",
|
|
24
|
+
"zod": "^4.6.7",
|
|
25
|
+
"zod-to-json-schema": "^3.25.2"
|
|
26
|
+
},
|
|
27
|
+
"devDependencies": {
|
|
28
|
+
"@types/node": "^20.0.0",
|
|
29
|
+
"tsx": "^4.15.0",
|
|
30
|
+
"typescript": "^5.5.0"
|
|
31
|
+
},
|
|
32
|
+
"engines": {
|
|
33
|
+
"node": ">=20.0.0"
|
|
34
|
+
}
|
|
35
|
+
}
|