@teamnetwork-nz/tailscale-mcp-server 1.0.2 → 1.1.0
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/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 +26 -61
- package/dist/index.js.map +1 -1
- package/package.json +12 -3
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.
|
|
@@ -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,13 @@
|
|
|
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
|
-
async function readJsonBody(req) {
|
|
13
|
-
return new Promise((resolve, reject) => {
|
|
14
|
-
const chunks = [];
|
|
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
|
-
}
|
|
27
11
|
async function main() {
|
|
28
12
|
let client;
|
|
29
13
|
try {
|
|
@@ -60,11 +44,12 @@ async function main() {
|
|
|
60
44
|
else {
|
|
61
45
|
process.stderr.write("[tailscale-mcp] Running in read-only mode (set TAILSCALE_READWRITE=true to enable write tools)\n");
|
|
62
46
|
}
|
|
63
|
-
const
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
47
|
+
const createConfiguredServer = () => {
|
|
48
|
+
const server = new McpServer({
|
|
49
|
+
name: "@teamnetwork-nz/tailscale-mcp-server",
|
|
50
|
+
version: "1.1.0",
|
|
51
|
+
}, {
|
|
52
|
+
instructions: `
|
|
68
53
|
Tailscale MCP server — manage a Tailscale tailnet via the Tailscale REST API.
|
|
69
54
|
|
|
70
55
|
## Mode
|
|
@@ -96,53 +81,33 @@ Tailscale MCP server — manage a Tailscale tailnet via the Tailscale REST API.
|
|
|
96
81
|
## DNS
|
|
97
82
|
- set_dns_nameservers and set_dns_searchpaths both replace the full list — include existing entries you want to keep alongside any new ones.
|
|
98
83
|
`.trim(),
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
84
|
+
});
|
|
85
|
+
registerDeviceTools(server, client);
|
|
86
|
+
registerKeyTools(server, client);
|
|
87
|
+
registerDnsTools(server, client);
|
|
88
|
+
registerAclTools(server, client);
|
|
89
|
+
if (readwrite)
|
|
90
|
+
registerActionTools(server, client);
|
|
91
|
+
return server;
|
|
92
|
+
};
|
|
106
93
|
if (transportMode === "http") {
|
|
107
94
|
const port = parseInt(process.env["TAILSCALE_HTTP_PORT"] ?? "3000", 10);
|
|
108
|
-
const host = process.env["TAILSCALE_HTTP_HOST"] ?? "
|
|
109
|
-
const
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
res.end(JSON.stringify({ status: "ok", server: "@teamnetwork-nz/tailscale-mcp-server" }));
|
|
118
|
-
return;
|
|
119
|
-
}
|
|
120
|
-
if (!url.startsWith("/mcp")) {
|
|
121
|
-
res.writeHead(404);
|
|
122
|
-
res.end();
|
|
123
|
-
return;
|
|
124
|
-
}
|
|
125
|
-
try {
|
|
126
|
-
if (req.method === "POST") {
|
|
127
|
-
const body = await readJsonBody(req);
|
|
128
|
-
await transport.handleRequest(req, res, body);
|
|
129
|
-
}
|
|
130
|
-
else {
|
|
131
|
-
await transport.handleRequest(req, res);
|
|
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
|
-
}
|
|
95
|
+
const host = process.env["TAILSCALE_HTTP_HOST"] ?? "127.0.0.1";
|
|
96
|
+
const httpServer = createHttpTransportServer(createConfiguredServer, {
|
|
97
|
+
host,
|
|
98
|
+
port,
|
|
99
|
+
serverName: "@teamnetwork-nz/tailscale-mcp-server",
|
|
100
|
+
bearerToken: process.env["TAILSCALE_HTTP_BEARER_TOKEN"],
|
|
101
|
+
allowedHosts: process.env["TAILSCALE_HTTP_ALLOWED_HOSTS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
102
|
+
allowedOrigins: process.env["TAILSCALE_HTTP_ALLOWED_ORIGINS"]?.split(",").map((value) => value.trim()).filter(Boolean),
|
|
103
|
+
maxBodyBytes: parseInt(process.env["TAILSCALE_HTTP_MAX_BODY_BYTES"] ?? "1048576", 10),
|
|
140
104
|
});
|
|
141
105
|
httpServer.listen(port, host, () => {
|
|
142
106
|
process.stderr.write(`[tailscale-mcp] HTTP transport listening on ${host}:${port}/mcp\n`);
|
|
143
107
|
});
|
|
144
108
|
}
|
|
145
109
|
else {
|
|
110
|
+
const server = createConfiguredServer();
|
|
146
111
|
const transport = new StdioServerTransport();
|
|
147
112
|
await server.connect(transport);
|
|
148
113
|
}
|
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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"}
|
package/package.json
CHANGED
|
@@ -1,17 +1,26 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@teamnetwork-nz/tailscale-mcp-server",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.1.0",
|
|
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"
|