@teamnetwork-nz/tailscale-mcp-server 1.0.2 → 1.1.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/README.md +9 -1
- package/dist/client.d.ts +22 -4
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +21 -4
- package/dist/client.js.map +1 -1
- package/dist/env.d.ts +2 -0
- package/dist/env.d.ts.map +1 -0
- package/dist/env.js +13 -0
- package/dist/env.js.map +1 -0
- package/dist/http-server.d.ts +14 -0
- package/dist/http-server.d.ts.map +1 -0
- package/dist/http-server.js +115 -0
- package/dist/http-server.js.map +1 -0
- package/dist/index.js +32 -63
- 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/strict-tools.d.ts +4 -0
- package/dist/strict-tools.d.ts.map +1 -0
- package/dist/strict-tools.js +30 -0
- package/dist/strict-tools.js.map +1 -0
- package/package.json +14 -5
package/README.md
CHANGED
|
@@ -43,7 +43,11 @@ Set these environment variables before starting the server:
|
|
|
43
43
|
| `TAILSCALE_IPV4_ONLY` | `false` | Set to `true` to force IPv4-only DNS resolution. Fixes slow/hanging requests on hosts with no working IPv6 route, where dual-stack (Happy Eyeballs) resolution has to time out on IPv6 before falling back |
|
|
44
44
|
| `TAILSCALE_TRANSPORT` | `stdio` | Transport mode: `stdio` (default, local) or `http` (remote agent hosting) |
|
|
45
45
|
| `TAILSCALE_HTTP_PORT` | `3000` | Port to listen on when `TAILSCALE_TRANSPORT=http` |
|
|
46
|
-
| `TAILSCALE_HTTP_HOST` | `
|
|
46
|
+
| `TAILSCALE_HTTP_HOST` | `127.0.0.1` | Bind address when `TAILSCALE_TRANSPORT=http` |
|
|
47
|
+
| `TAILSCALE_HTTP_BEARER_TOKEN` | unset | Token required in `Authorization: Bearer ...`; mandatory for non-loopback binding |
|
|
48
|
+
| `TAILSCALE_HTTP_ALLOWED_HOSTS` | unset | Comma-separated allowed `Host` header values; mandatory for non-loopback binding |
|
|
49
|
+
| `TAILSCALE_HTTP_ALLOWED_ORIGINS` | unset | Comma-separated browser origins permitted to call `/mcp` |
|
|
50
|
+
| `TAILSCALE_HTTP_MAX_BODY_BYTES` | `1048576` | Maximum HTTP request body size |
|
|
47
51
|
|
|
48
52
|
## Tools
|
|
49
53
|
|
|
@@ -110,9 +114,12 @@ Set `TAILSCALE_TRANSPORT=http` to start an HTTP server instead of reading from s
|
|
|
110
114
|
```bash
|
|
111
115
|
TAILSCALE_API_KEY=tskey-api-your-key \
|
|
112
116
|
TAILSCALE_TRANSPORT=http \
|
|
117
|
+
TAILSCALE_HTTP_BEARER_TOKEN=replace-with-a-long-random-secret \
|
|
113
118
|
npx @teamnetwork-nz/tailscale-mcp-server
|
|
114
119
|
```
|
|
115
120
|
|
|
121
|
+
The listener defaults to loopback. To expose it directly or from a container, set `TAILSCALE_HTTP_HOST=0.0.0.0`, `TAILSCALE_HTTP_BEARER_TOKEN`, and `TAILSCALE_HTTP_ALLOWED_HOSTS` (including the port when one appears in the request's `Host` header). TLS should be terminated by a trusted reverse proxy.
|
|
122
|
+
|
|
116
123
|
## Development
|
|
117
124
|
|
|
118
125
|
```bash
|
|
@@ -124,5 +131,6 @@ npm start
|
|
|
124
131
|
## Security notes
|
|
125
132
|
|
|
126
133
|
- The server runs in **read-only mode by default**. Write tools must be explicitly enabled via `TAILSCALE_READWRITE=true`.
|
|
134
|
+
- Remote HTTP access is restricted to loopback by default. Non-loopback listeners require bearer authentication and an explicit host allowlist.
|
|
127
135
|
- `delete_device`, `expire_device_key`, and `update_acl` are disruptive and effectively irreversible — review the tool descriptions and confirm with the model/client before granting write access in a production tailnet.
|
|
128
136
|
- `create_auth_key` returns the plaintext key exactly once in the tool response. It cannot be retrieved again — store it immediately.
|
package/dist/client.d.ts
CHANGED
|
@@ -1,10 +1,27 @@
|
|
|
1
|
-
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export declare const ClientConfigSchema: z.ZodObject<{
|
|
3
|
+
baseUrl: z.ZodString;
|
|
4
|
+
apiKey: z.ZodString;
|
|
5
|
+
tailnet: z.ZodString;
|
|
6
|
+
timeoutMs: z.ZodOptional<z.ZodNumber>;
|
|
7
|
+
ipv4Only: z.ZodOptional<z.ZodBoolean>;
|
|
8
|
+
readWrite: z.ZodBoolean;
|
|
9
|
+
}, "strict", z.ZodTypeAny, {
|
|
2
10
|
baseUrl: string;
|
|
3
11
|
apiKey: string;
|
|
4
12
|
tailnet: string;
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
13
|
+
readWrite: boolean;
|
|
14
|
+
timeoutMs?: number | undefined;
|
|
15
|
+
ipv4Only?: boolean | undefined;
|
|
16
|
+
}, {
|
|
17
|
+
baseUrl: string;
|
|
18
|
+
apiKey: string;
|
|
19
|
+
tailnet: string;
|
|
20
|
+
readWrite: boolean;
|
|
21
|
+
timeoutMs?: number | undefined;
|
|
22
|
+
ipv4Only?: boolean | undefined;
|
|
23
|
+
}>;
|
|
24
|
+
export type ClientConfig = z.infer<typeof ClientConfigSchema>;
|
|
8
25
|
export declare class TailscaleApiError extends Error {
|
|
9
26
|
readonly statusCode: number;
|
|
10
27
|
constructor(statusCode: number, message: string);
|
|
@@ -14,6 +31,7 @@ export declare class TailscaleClient {
|
|
|
14
31
|
private readonly tailnet;
|
|
15
32
|
private readonly headers;
|
|
16
33
|
private readonly timeoutMs;
|
|
34
|
+
private readonly readWrite;
|
|
17
35
|
private readonly dispatcher;
|
|
18
36
|
constructor(config: ClientConfig);
|
|
19
37
|
/** Options shared by every fetch call: connect/response timeout and the configured dispatcher. */
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAOpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAuB9D,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM;CAKlB;AAkBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,YAAY;IAkBhC,kGAAkG;IAClG,OAAO,CAAC,YAAY;IAQpB,IAAI,WAAW,IAAI,MAAM,CAExB;YAEa,OAAO;IA6CrB,uFAAuF;IACjF,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBvE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAIrB,cAAc;CA2C7B;AAED,wBAAgB,YAAY,IAAI,eAAe,CAW9C"}
|
package/dist/client.js
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
import { Agent, fetch } from "undici";
|
|
2
|
+
import { parsePositiveInt } from "./env.js";
|
|
3
|
+
import { z } from "zod";
|
|
2
4
|
const DEFAULT_BASE_URL = "https://api.tailscale.com/api/v2";
|
|
3
5
|
const DEFAULT_TIMEOUT_MS = 8_000;
|
|
6
|
+
export const ClientConfigSchema = z.object({
|
|
7
|
+
baseUrl: z.string().url(),
|
|
8
|
+
apiKey: z.string().min(1),
|
|
9
|
+
tailnet: z.string().min(1),
|
|
10
|
+
timeoutMs: z.number().int().min(1).max(300_000).optional(),
|
|
11
|
+
ipv4Only: z.boolean().optional(),
|
|
12
|
+
readWrite: z.boolean(),
|
|
13
|
+
}).strict();
|
|
4
14
|
/**
|
|
5
15
|
* Unpacks undici's dual-stack (Happy Eyeballs) connection errors, which arrive as
|
|
6
16
|
* `err.cause.errors[]` rather than a single `err.cause.message` — e.g. on IPv4-only
|
|
@@ -45,6 +55,7 @@ export class TailscaleClient {
|
|
|
45
55
|
tailnet;
|
|
46
56
|
headers;
|
|
47
57
|
timeoutMs;
|
|
58
|
+
readWrite;
|
|
48
59
|
dispatcher;
|
|
49
60
|
constructor(config) {
|
|
50
61
|
this.baseUrl = config.baseUrl.replace(/\/$/, "");
|
|
@@ -55,6 +66,7 @@ export class TailscaleClient {
|
|
|
55
66
|
"Content-Type": "application/json",
|
|
56
67
|
};
|
|
57
68
|
this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
|
|
69
|
+
this.readWrite = config.readWrite;
|
|
58
70
|
this.dispatcher = new Agent({
|
|
59
71
|
connect: {
|
|
60
72
|
timeout: this.timeoutMs,
|
|
@@ -74,6 +86,9 @@ export class TailscaleClient {
|
|
|
74
86
|
return this.tailnet;
|
|
75
87
|
}
|
|
76
88
|
async request(method, path, options = {}) {
|
|
89
|
+
if (method.toUpperCase() !== "GET" && !this.readWrite) {
|
|
90
|
+
throw new Error("Write operations are disabled. Set TAILSCALE_READWRITE=true to enable them.");
|
|
91
|
+
}
|
|
77
92
|
const url = `${this.baseUrl}${path}`;
|
|
78
93
|
let res;
|
|
79
94
|
try {
|
|
@@ -146,6 +161,9 @@ export class TailscaleClient {
|
|
|
146
161
|
return this.request("DELETE", path);
|
|
147
162
|
}
|
|
148
163
|
async requestRawBody(method, path, body, contentType) {
|
|
164
|
+
if (method.toUpperCase() !== "GET" && !this.readWrite) {
|
|
165
|
+
throw new Error("Write operations are disabled. Set TAILSCALE_READWRITE=true to enable them.");
|
|
166
|
+
}
|
|
149
167
|
const url = `${this.baseUrl}${path}`;
|
|
150
168
|
let res;
|
|
151
169
|
try {
|
|
@@ -186,11 +204,10 @@ export function createClient() {
|
|
|
186
204
|
const tailnet = process.env["TAILSCALE_TAILNET"] ?? "-";
|
|
187
205
|
const baseUrl = process.env["TAILSCALE_BASE_URL"] ?? DEFAULT_BASE_URL;
|
|
188
206
|
const ipv4Only = process.env["TAILSCALE_IPV4_ONLY"] === "true";
|
|
189
|
-
const timeoutMs = process.env["TAILSCALE_TIMEOUT_MS"]
|
|
190
|
-
? parseInt(process.env["TAILSCALE_TIMEOUT_MS"], 10)
|
|
191
|
-
: DEFAULT_TIMEOUT_MS;
|
|
207
|
+
const timeoutMs = parsePositiveInt("TAILSCALE_TIMEOUT_MS", process.env["TAILSCALE_TIMEOUT_MS"], DEFAULT_TIMEOUT_MS, 300_000);
|
|
192
208
|
if (!apiKey)
|
|
193
209
|
throw new Error("TAILSCALE_API_KEY environment variable is required.");
|
|
194
|
-
|
|
210
|
+
const readWrite = (process.env["TAILSCALE_READWRITE"] ?? "").toLowerCase() === "true";
|
|
211
|
+
return new TailscaleClient(ClientConfigSchema.parse({ baseUrl, apiKey, tailnet, timeoutMs, ipv4Only, readWrite }));
|
|
195
212
|
}
|
|
196
213
|
//# sourceMappingURL=client.js.map
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAiB,MAAM,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
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,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAUR"}
|
package/dist/env.js
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export function parsePositiveInt(name, raw, fallback, maximum) {
|
|
2
|
+
if (raw === undefined || raw.trim() === '')
|
|
3
|
+
return fallback;
|
|
4
|
+
if (!/^\d+$/.test(raw.trim())) {
|
|
5
|
+
throw new Error(`${name} must be an integer from 1 to ${maximum}`);
|
|
6
|
+
}
|
|
7
|
+
const value = Number(raw);
|
|
8
|
+
if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
|
|
9
|
+
throw new Error(`${name} must be an integer from 1 to ${maximum}`);
|
|
10
|
+
}
|
|
11
|
+
return value;
|
|
12
|
+
}
|
|
13
|
+
//# 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,CAC9B,IAAY,EACZ,GAAuB,EACvB,QAAgB,EAChB,OAAe;IAEf,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC5D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iCAAiC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,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,iCAAiC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import http from "node:http";
|
|
2
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
|
+
export interface HttpServerOptions {
|
|
4
|
+
host: string;
|
|
5
|
+
port: number;
|
|
6
|
+
serverName: string;
|
|
7
|
+
bearerToken?: string;
|
|
8
|
+
allowedHosts?: string[];
|
|
9
|
+
allowedOrigins?: string[];
|
|
10
|
+
maxBodyBytes?: number;
|
|
11
|
+
}
|
|
12
|
+
export declare function validateHttpOptions(options: HttpServerOptions): void;
|
|
13
|
+
export declare function createHttpTransportServer(createServer: () => McpServer, options: HttpServerOptions): http.Server;
|
|
14
|
+
//# sourceMappingURL=http-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC,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;AAgDD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAapE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,SAAS,EAC7B,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAAC,MAAM,CAuDb"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { timingSafeEqual } from "node:crypto";
|
|
2
|
+
import http from "node:http";
|
|
3
|
+
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
|
|
4
|
+
const LOOPBACK_HOSTS = new Set(["127.0.0.1", "::1", "localhost"]);
|
|
5
|
+
function json(res, status, body) {
|
|
6
|
+
res.writeHead(status, { "Content-Type": "application/json" });
|
|
7
|
+
res.end(JSON.stringify(body));
|
|
8
|
+
}
|
|
9
|
+
function rpcError(res, status, code, message) {
|
|
10
|
+
json(res, status, { jsonrpc: "2.0", error: { code, message }, id: null });
|
|
11
|
+
}
|
|
12
|
+
function tokenMatches(header, expected) {
|
|
13
|
+
if (!header?.startsWith("Bearer "))
|
|
14
|
+
return false;
|
|
15
|
+
const supplied = Buffer.from(header.slice(7));
|
|
16
|
+
const wanted = Buffer.from(expected);
|
|
17
|
+
return supplied.length === wanted.length && timingSafeEqual(supplied, wanted);
|
|
18
|
+
}
|
|
19
|
+
async function readJsonBody(req, limit) {
|
|
20
|
+
return new Promise((resolve, reject) => {
|
|
21
|
+
const chunks = [];
|
|
22
|
+
let size = 0;
|
|
23
|
+
let tooLarge = false;
|
|
24
|
+
req.on("data", (chunk) => {
|
|
25
|
+
size += chunk.length;
|
|
26
|
+
if (size > limit) {
|
|
27
|
+
tooLarge = true;
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
chunks.push(chunk);
|
|
31
|
+
});
|
|
32
|
+
req.on("end", () => {
|
|
33
|
+
if (tooLarge) {
|
|
34
|
+
reject(Object.assign(new Error("Request body too large"), { statusCode: 413 }));
|
|
35
|
+
return;
|
|
36
|
+
}
|
|
37
|
+
try {
|
|
38
|
+
resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
reject(Object.assign(new Error("Invalid JSON body"), { statusCode: 400 }));
|
|
42
|
+
}
|
|
43
|
+
});
|
|
44
|
+
req.on("error", reject);
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
export function validateHttpOptions(options) {
|
|
48
|
+
if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) {
|
|
49
|
+
throw new Error(`Invalid HTTP port: ${options.port}`);
|
|
50
|
+
}
|
|
51
|
+
if (options.maxBodyBytes !== undefined && (!Number.isInteger(options.maxBodyBytes) || options.maxBodyBytes < 1)) {
|
|
52
|
+
throw new Error(`Invalid HTTP body limit: ${options.maxBodyBytes}`);
|
|
53
|
+
}
|
|
54
|
+
if (!LOOPBACK_HOSTS.has(options.host) && !options.bearerToken) {
|
|
55
|
+
throw new Error("A bearer token is required when the HTTP server binds beyond loopback");
|
|
56
|
+
}
|
|
57
|
+
if (!LOOPBACK_HOSTS.has(options.host) && !options.allowedHosts?.length) {
|
|
58
|
+
throw new Error("HTTP_ALLOWED_HOSTS is required when the HTTP server binds beyond loopback");
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
export function createHttpTransportServer(createServer, options) {
|
|
62
|
+
validateHttpOptions(options);
|
|
63
|
+
const allowedHosts = new Set(options.allowedHosts?.map((value) => value.toLowerCase()));
|
|
64
|
+
const allowedOrigins = new Set(options.allowedOrigins?.map((value) => value.toLowerCase()));
|
|
65
|
+
const maxBodyBytes = options.maxBodyBytes ?? 1024 * 1024;
|
|
66
|
+
return http.createServer(async (req, res) => {
|
|
67
|
+
const url = new URL(req.url ?? "/", "http://localhost");
|
|
68
|
+
if (url.pathname === "/health") {
|
|
69
|
+
json(res, 200, { status: "ok", server: options.serverName });
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
if (url.pathname !== "/mcp") {
|
|
73
|
+
res.writeHead(404).end();
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
if (allowedHosts.size && !allowedHosts.has((req.headers.host ?? "").toLowerCase())) {
|
|
77
|
+
rpcError(res, 403, -32000, "Host not allowed");
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
if (req.headers.origin && !allowedOrigins.has(req.headers.origin.toLowerCase())) {
|
|
81
|
+
rpcError(res, 403, -32000, "Origin not allowed");
|
|
82
|
+
return;
|
|
83
|
+
}
|
|
84
|
+
if (options.bearerToken && !tokenMatches(req.headers.authorization, options.bearerToken)) {
|
|
85
|
+
res.setHeader("WWW-Authenticate", "Bearer");
|
|
86
|
+
rpcError(res, 401, -32001, "Unauthorized");
|
|
87
|
+
return;
|
|
88
|
+
}
|
|
89
|
+
if (req.method !== "POST") {
|
|
90
|
+
res.setHeader("Allow", "POST");
|
|
91
|
+
rpcError(res, 405, -32000, "Method not allowed");
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
const server = createServer();
|
|
95
|
+
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
|
|
96
|
+
try {
|
|
97
|
+
const body = await readJsonBody(req, maxBodyBytes);
|
|
98
|
+
await server.connect(transport);
|
|
99
|
+
await transport.handleRequest(req, res, body);
|
|
100
|
+
res.once("close", () => {
|
|
101
|
+
void transport.close();
|
|
102
|
+
void server.close();
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
catch (error) {
|
|
106
|
+
void transport.close();
|
|
107
|
+
void server.close();
|
|
108
|
+
if (!res.headersSent) {
|
|
109
|
+
const status = error.statusCode ?? 500;
|
|
110
|
+
rpcError(res, status, status === 400 ? -32700 : -32603, status < 500 ? error.message : "Internal server error");
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=http-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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,29 +1,16 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import http from "node:http";
|
|
3
2
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
4
3
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
5
|
-
import {
|
|
4
|
+
import { createHttpTransportServer } from "./http-server.js";
|
|
6
5
|
import { createClient } from "./client.js";
|
|
7
6
|
import { registerDeviceTools } from "./tools/devices.js";
|
|
8
7
|
import { registerKeyTools } from "./tools/keys.js";
|
|
9
8
|
import { registerDnsTools } from "./tools/dns.js";
|
|
10
9
|
import { registerAclTools } from "./tools/acl.js";
|
|
11
10
|
import { registerActionTools } from "./tools/actions.js";
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
req.on("data", (chunk) => chunks.push(chunk));
|
|
16
|
-
req.on("end", () => {
|
|
17
|
-
try {
|
|
18
|
-
resolve(JSON.parse(Buffer.concat(chunks).toString()));
|
|
19
|
-
}
|
|
20
|
-
catch {
|
|
21
|
-
resolve(undefined);
|
|
22
|
-
}
|
|
23
|
-
});
|
|
24
|
-
req.on("error", reject);
|
|
25
|
-
});
|
|
26
|
-
}
|
|
11
|
+
import { packageName, packageVersion } from "./package-info.js";
|
|
12
|
+
import { enforceStrictToolInputs } from "./strict-tools.js";
|
|
13
|
+
import { parsePositiveInt } from "./env.js";
|
|
27
14
|
async function main() {
|
|
28
15
|
let client;
|
|
29
16
|
try {
|
|
@@ -33,7 +20,7 @@ async function main() {
|
|
|
33
20
|
process.stderr.write(`[tailscale-mcp] Configuration error: ${err.message}\n`);
|
|
34
21
|
process.exit(1);
|
|
35
22
|
}
|
|
36
|
-
const readwrite = process.env["TAILSCALE_READWRITE"] === "true";
|
|
23
|
+
const readwrite = (process.env["TAILSCALE_READWRITE"] ?? "").toLowerCase() === "true";
|
|
37
24
|
const transportMode = process.env["TAILSCALE_TRANSPORT"] ?? "stdio";
|
|
38
25
|
process.stderr.write(`[tailscale-mcp] Tailnet: ${client.tailnetName}\n`);
|
|
39
26
|
// Startup connectivity check — warn early rather than failing silently on first tool call
|
|
@@ -60,11 +47,12 @@ async function main() {
|
|
|
60
47
|
else {
|
|
61
48
|
process.stderr.write("[tailscale-mcp] Running in read-only mode (set TAILSCALE_READWRITE=true to enable write tools)\n");
|
|
62
49
|
}
|
|
63
|
-
const
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
50
|
+
const createConfiguredServer = () => {
|
|
51
|
+
const server = new McpServer({
|
|
52
|
+
name: packageName,
|
|
53
|
+
version: packageVersion,
|
|
54
|
+
}, {
|
|
55
|
+
instructions: `
|
|
68
56
|
Tailscale MCP server — manage a Tailscale tailnet via the Tailscale REST API.
|
|
69
57
|
|
|
70
58
|
## Mode
|
|
@@ -96,53 +84,34 @@ Tailscale MCP server — manage a Tailscale tailnet via the Tailscale REST API.
|
|
|
96
84
|
## DNS
|
|
97
85
|
- set_dns_nameservers and set_dns_searchpaths both replace the full list — include existing entries you want to keep alongside any new ones.
|
|
98
86
|
`.trim(),
|
|
99
|
-
});
|
|
100
|
-
registerDeviceTools(server, client);
|
|
101
|
-
registerKeyTools(server, client);
|
|
102
|
-
registerDnsTools(server, client);
|
|
103
|
-
registerAclTools(server, client);
|
|
104
|
-
if (readwrite)
|
|
105
|
-
registerActionTools(server, client);
|
|
106
|
-
if (transportMode === "http") {
|
|
107
|
-
const port = parseInt(process.env["TAILSCALE_HTTP_PORT"] ?? "3000", 10);
|
|
108
|
-
const host = process.env["TAILSCALE_HTTP_HOST"] ?? "0.0.0.0";
|
|
109
|
-
const transport = new StreamableHTTPServerTransport({
|
|
110
|
-
sessionIdGenerator: undefined, // stateless — suitable for remote agent hosting
|
|
111
87
|
});
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
}
|
|
133
|
-
}
|
|
134
|
-
catch (err) {
|
|
135
|
-
if (!res.headersSent) {
|
|
136
|
-
res.writeHead(500, { "Content-Type": "application/json" });
|
|
137
|
-
res.end(JSON.stringify({ error: err.message }));
|
|
138
|
-
}
|
|
139
|
-
}
|
|
88
|
+
enforceStrictToolInputs(server);
|
|
89
|
+
registerDeviceTools(server, client);
|
|
90
|
+
registerKeyTools(server, client);
|
|
91
|
+
registerDnsTools(server, client);
|
|
92
|
+
registerAclTools(server, client);
|
|
93
|
+
if (readwrite)
|
|
94
|
+
registerActionTools(server, client);
|
|
95
|
+
return server;
|
|
96
|
+
};
|
|
97
|
+
if (transportMode === "http") {
|
|
98
|
+
const port = parsePositiveInt("TAILSCALE_HTTP_PORT", process.env["TAILSCALE_HTTP_PORT"], 3000, 65535);
|
|
99
|
+
const host = process.env["TAILSCALE_HTTP_HOST"] ?? "127.0.0.1";
|
|
100
|
+
const httpServer = createHttpTransportServer(createConfiguredServer, {
|
|
101
|
+
host,
|
|
102
|
+
port,
|
|
103
|
+
serverName: "@teamnetwork-nz/tailscale-mcp-server",
|
|
104
|
+
bearerToken: process.env["TAILSCALE_HTTP_BEARER_TOKEN"],
|
|
105
|
+
allowedHosts: process.env["TAILSCALE_HTTP_ALLOWED_HOSTS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
106
|
+
allowedOrigins: process.env["TAILSCALE_HTTP_ALLOWED_ORIGINS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
107
|
+
maxBodyBytes: parsePositiveInt("TAILSCALE_HTTP_MAX_BODY_BYTES", process.env["TAILSCALE_HTTP_MAX_BODY_BYTES"], 1_048_576, 16_777_216),
|
|
140
108
|
});
|
|
141
109
|
httpServer.listen(port, host, () => {
|
|
142
110
|
process.stderr.write(`[tailscale-mcp] HTTP transport listening on ${host}:${port}/mcp\n`);
|
|
143
111
|
});
|
|
144
112
|
}
|
|
145
113
|
else {
|
|
114
|
+
const server = createConfiguredServer();
|
|
146
115
|
const transport = new StdioServerTransport();
|
|
147
116
|
await server.connect(transport);
|
|
148
117
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,
|
|
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,QAAqC,CAAC;AAC9D,eAAO,MAAM,cAAc,QAAyB,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 pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8"));
|
|
5
|
+
export const packageName = pkg.name ?? "tailscale-mcp-server";
|
|
6
|
+
export const packageVersion = pkg.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,GAAG,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;AACzJ,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,IAAI,sBAAsB,CAAC;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
/** Make every tool object reject undeclared arguments, including no-argument tools. */
|
|
3
|
+
export declare function enforceStrictToolInputs(server: McpServer): void;
|
|
4
|
+
//# sourceMappingURL=strict-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strict-tools.d.ts","sourceRoot":"","sources":["../src/strict-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQ/D"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
function isSchema(value) {
|
|
3
|
+
return typeof value === "object" && value !== null && "_def" in value;
|
|
4
|
+
}
|
|
5
|
+
function isRawShape(value) {
|
|
6
|
+
if (typeof value !== "object" || value === null || isSchema(value))
|
|
7
|
+
return false;
|
|
8
|
+
const values = Object.values(value);
|
|
9
|
+
return values.length === 0 || values.some(isSchema);
|
|
10
|
+
}
|
|
11
|
+
function strictSchema(schema) {
|
|
12
|
+
if (schema === undefined)
|
|
13
|
+
return z.object({}).strict();
|
|
14
|
+
if (isRawShape(schema))
|
|
15
|
+
return z.object(schema).strict();
|
|
16
|
+
if (isSchema(schema) && typeof schema.strict === "function")
|
|
17
|
+
return schema.strict();
|
|
18
|
+
return schema;
|
|
19
|
+
}
|
|
20
|
+
/** Make every tool object reject undeclared arguments, including no-argument tools. */
|
|
21
|
+
export function enforceStrictToolInputs(server) {
|
|
22
|
+
const mutable = server;
|
|
23
|
+
const createRegisteredTool = mutable._createRegisteredTool.bind(server);
|
|
24
|
+
mutable._createRegisteredTool = (...args) => {
|
|
25
|
+
// SDK 1.29 funnels both tool() and registerTool() through this method.
|
|
26
|
+
args[3] = strictSchema(args[3]);
|
|
27
|
+
return createRegisteredTool(...args);
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=strict-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strict-tools.js","sourceRoot":"","sources":["../src/strict-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACvD,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACzD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;IACpF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,OAAO,GAAG,MAAqC,CAAC;IACtD,MAAM,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxE,OAAO,CAAC,qBAAqB,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACrD,uEAAuE;QACvE,IAAI,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,oBAAoB,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,25 +1,34 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@teamnetwork-nz/tailscale-mcp-server",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"description": "MCP server for the Tailscale API — manage devices, ACLs, DNS, subnet routes, and auth keys",
|
|
5
|
-
"keywords": [
|
|
5
|
+
"keywords": [
|
|
6
|
+
"mcp",
|
|
7
|
+
"tailscale",
|
|
8
|
+
"vpn",
|
|
9
|
+
"networking",
|
|
10
|
+
"claude"
|
|
11
|
+
],
|
|
6
12
|
"license": "MIT",
|
|
7
13
|
"type": "module",
|
|
8
14
|
"bin": {
|
|
9
15
|
"tailscale-mcp-server": "./dist/index.js"
|
|
10
16
|
},
|
|
11
17
|
"main": "./dist/index.js",
|
|
12
|
-
"files": [
|
|
18
|
+
"files": [
|
|
19
|
+
"dist"
|
|
20
|
+
],
|
|
13
21
|
"scripts": {
|
|
14
22
|
"build": "tsc",
|
|
23
|
+
"test": "npm run build && node --test tests/*.test.mjs",
|
|
15
24
|
"dev": "tsc --watch",
|
|
16
25
|
"start": "node dist/index.js",
|
|
17
26
|
"prepublishOnly": "npm run build"
|
|
18
27
|
},
|
|
19
28
|
"dependencies": {
|
|
20
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
29
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
21
30
|
"undici": "^6.19.0",
|
|
22
|
-
"zod": "^3.
|
|
31
|
+
"zod": "^3.25.0"
|
|
23
32
|
},
|
|
24
33
|
"devDependencies": {
|
|
25
34
|
"@types/node": "^18.19.0",
|