@teamnetwork-nz/teamlink-mcp-server 0.6.0 → 0.6.1
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/dist/env.js +7 -0
- package/{build → dist}/index.js +30 -12
- package/dist/index.js.map +1 -0
- package/package.json +11 -9
- /package/{build → dist}/http-server.js +0 -0
package/dist/env.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
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
|
+
}
|
package/{build → dist}/index.js
RENAMED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import 'dotenv
|
|
2
|
+
import dotenv from 'dotenv';
|
|
3
3
|
import { readFileSync } from 'node:fs';
|
|
4
4
|
import { fileURLToPath } from 'node:url';
|
|
5
5
|
import { dirname, join } from 'node:path';
|
|
@@ -8,6 +8,8 @@ import { z } from 'zod';
|
|
|
8
8
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
9
9
|
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
10
10
|
import { createHttpServer } from './http-server.js';
|
|
11
|
+
import { parsePositiveInt } from './env.js';
|
|
12
|
+
dotenv.config({ quiet: true });
|
|
11
13
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
12
14
|
function pkgVersion() {
|
|
13
15
|
try {
|
|
@@ -26,14 +28,24 @@ function pkgVersion() {
|
|
|
26
28
|
* - TEAMLINK_API_BASE (default http://localhost:3100)
|
|
27
29
|
* - TEAMLINK_API_KEY the staff-allocated CSCApiKey used for all calls
|
|
28
30
|
*/
|
|
29
|
-
const
|
|
30
|
-
|
|
31
|
+
export const TeamlinkConfigSchema = z.object({
|
|
32
|
+
apiBase: z.string().url(),
|
|
33
|
+
apiKey: z.string().min(1, 'TEAMLINK_API_KEY is required'),
|
|
34
|
+
readWrite: z.boolean(),
|
|
35
|
+
}).strict();
|
|
31
36
|
/**
|
|
32
37
|
* Write-tool gate. Defaults to false (non-destructive/read-only) so this server
|
|
33
38
|
* is safe to point at production unless explicitly opted in. Accepts common
|
|
34
|
-
*
|
|
39
|
+
* only the case-insensitive value "true" enables writes.
|
|
35
40
|
*/
|
|
36
|
-
const
|
|
41
|
+
const teamlinkConfig = TeamlinkConfigSchema.parse({
|
|
42
|
+
apiBase: (process.env.TEAMLINK_API_BASE ?? 'http://localhost:3100').replace(/\/$/, ''),
|
|
43
|
+
apiKey: process.env.TEAMLINK_API_KEY ?? '',
|
|
44
|
+
readWrite: (process.env.TEAMLINK_READWRITE ?? '').toLowerCase() === 'true',
|
|
45
|
+
});
|
|
46
|
+
const API_BASE = teamlinkConfig.apiBase;
|
|
47
|
+
const API_KEY = teamlinkConfig.apiKey;
|
|
48
|
+
const READWRITE = teamlinkConfig.readWrite;
|
|
37
49
|
const http = axios.create({
|
|
38
50
|
baseURL: API_BASE,
|
|
39
51
|
timeout: 20_000,
|
|
@@ -83,6 +95,8 @@ async function get(path, params) {
|
|
|
83
95
|
}
|
|
84
96
|
}
|
|
85
97
|
async function post(path, body) {
|
|
98
|
+
if (!READWRITE)
|
|
99
|
+
return usageError('Write operations are disabled. Set TEAMLINK_READWRITE=true to enable them.');
|
|
86
100
|
try {
|
|
87
101
|
const r = await http.post(path, body);
|
|
88
102
|
return ok(r.data);
|
|
@@ -92,6 +106,8 @@ async function post(path, body) {
|
|
|
92
106
|
}
|
|
93
107
|
}
|
|
94
108
|
async function put(path, body) {
|
|
109
|
+
if (!READWRITE)
|
|
110
|
+
return usageError('Write operations are disabled. Set TEAMLINK_READWRITE=true to enable them.');
|
|
95
111
|
try {
|
|
96
112
|
const r = await http.put(path, body);
|
|
97
113
|
return ok(r.data);
|
|
@@ -313,27 +329,29 @@ strictTool('product_search', 'Search the read-only product catalog. `q` splits o
|
|
|
313
329
|
page: z.number().optional(), pageSize: z.number().optional(),
|
|
314
330
|
}, async (args) => get('/orders/products/search', args));
|
|
315
331
|
function createConfiguredServer() {
|
|
316
|
-
const server = new McpServer({ name: 'teamlink-mcp', version: pkgVersion() }
|
|
332
|
+
const server = new McpServer({ name: '@teamnetwork-nz/teamlink-mcp-server', version: pkgVersion() }, {
|
|
333
|
+
instructions: 'TEAMlink business operations MCP server supporting stdio and HTTP. Read-only by default; mutation tools are available only when TEAMLINK_READWRITE=true. Use the most specific search filters available and treat customer, order, invoice, and credential data as sensitive.',
|
|
334
|
+
});
|
|
317
335
|
for (const register of registrations)
|
|
318
336
|
register(server);
|
|
319
337
|
return server;
|
|
320
338
|
}
|
|
321
339
|
async function main() {
|
|
322
340
|
if (!API_KEY) {
|
|
323
|
-
|
|
341
|
+
process.stderr.write('[teamlink-mcp] WARNING: TEAMLINK_API_KEY is not set; all tool calls will fail until it is configured.\n');
|
|
324
342
|
}
|
|
325
|
-
|
|
343
|
+
process.stderr.write(`[teamlink-mcp] mode: ${READWRITE ? 'READ-WRITE (write tools enabled)' : 'read-only (set TEAMLINK_READWRITE=true to enable write tools)'}\n`);
|
|
326
344
|
if ((process.env.TEAMLINK_TRANSPORT ?? 'stdio') === 'http') {
|
|
327
345
|
const host = process.env.TEAMLINK_HTTP_HOST ?? '127.0.0.1';
|
|
328
|
-
const port =
|
|
329
|
-
createHttpServer(createConfiguredServer, { host, port, serverName: '@teamnetwork-nz/teamlink-mcp-server', bearerToken: process.env.TEAMLINK_HTTP_BEARER_TOKEN, allowedHosts: process.env.TEAMLINK_HTTP_ALLOWED_HOSTS?.split(',').map(v => v.trim()).filter(Boolean), allowedOrigins: process.env.TEAMLINK_HTTP_ALLOWED_ORIGINS?.split(',').map(v => v.trim()).filter(Boolean) }).listen(port, host, () =>
|
|
346
|
+
const port = parsePositiveInt('TEAMLINK_HTTP_PORT', process.env.TEAMLINK_HTTP_PORT, 3000, 65535);
|
|
347
|
+
createHttpServer(createConfiguredServer, { host, port, serverName: '@teamnetwork-nz/teamlink-mcp-server', bearerToken: process.env.TEAMLINK_HTTP_BEARER_TOKEN, allowedHosts: process.env.TEAMLINK_HTTP_ALLOWED_HOSTS?.split(',').map(v => v.trim()).filter(Boolean), allowedOrigins: process.env.TEAMLINK_HTTP_ALLOWED_ORIGINS?.split(',').map(v => v.trim()).filter(Boolean), maxBodyBytes: parsePositiveInt('TEAMLINK_HTTP_MAX_BODY_BYTES', process.env.TEAMLINK_HTTP_MAX_BODY_BYTES, 1_048_576, 16_777_216) }).listen(port, host, () => process.stderr.write(`[teamlink-mcp] connected (http ${host}:${port}/mcp), proxying ${API_BASE}\n`));
|
|
330
348
|
}
|
|
331
349
|
else {
|
|
332
350
|
await createConfiguredServer().connect(new StdioServerTransport());
|
|
333
|
-
|
|
351
|
+
process.stderr.write(`[teamlink-mcp] connected (stdio), proxying ${API_BASE}\n`);
|
|
334
352
|
}
|
|
335
353
|
}
|
|
336
354
|
main().catch((e) => {
|
|
337
|
-
|
|
355
|
+
process.stderr.write(`[teamlink-mcp] fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}\n`);
|
|
338
356
|
process.exit(1);
|
|
339
357
|
});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,32 +1,34 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@teamnetwork-nz/teamlink-mcp-server",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.1",
|
|
4
4
|
"private": false,
|
|
5
|
-
"description": "
|
|
6
|
-
"main": "
|
|
5
|
+
"description": "MCP server exposing TEAMlink REST API tools over stdio and Streamable HTTP",
|
|
6
|
+
"main": "dist/index.js",
|
|
7
7
|
"type": "module",
|
|
8
8
|
"bin": {
|
|
9
|
-
"teamlink-mcp-server": "
|
|
9
|
+
"teamlink-mcp-server": "dist/index.js"
|
|
10
10
|
},
|
|
11
11
|
"files": [
|
|
12
|
-
"
|
|
12
|
+
"dist"
|
|
13
13
|
],
|
|
14
14
|
"scripts": {
|
|
15
15
|
"build": "tsc",
|
|
16
16
|
"test": "npm run build && node --test tests/*.test.mjs",
|
|
17
|
-
"start": "node
|
|
17
|
+
"start": "node dist/index.js",
|
|
18
|
+
"dev": "tsc --watch",
|
|
19
|
+
"typecheck": "tsc --noEmit"
|
|
18
20
|
},
|
|
19
21
|
"dependencies": {
|
|
20
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
22
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
21
23
|
"axios": "^1.4.0",
|
|
22
24
|
"dotenv": "^16.0.3",
|
|
23
|
-
"zod": "^
|
|
25
|
+
"zod": "^3.25.0"
|
|
24
26
|
},
|
|
25
27
|
"devDependencies": {
|
|
26
28
|
"@types/node": "^20.4.2",
|
|
27
29
|
"typescript": "^5.9.3"
|
|
28
30
|
},
|
|
29
31
|
"engines": {
|
|
30
|
-
"node": ">=
|
|
32
|
+
"node": ">=20"
|
|
31
33
|
}
|
|
32
34
|
}
|
|
File without changes
|