@sendsafely/mcp-server-local 0.0.0-stage → 1.0.5

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.
Files changed (134) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +22 -0
  3. package/README.md +390 -2
  4. package/dist/context.d.ts +2 -0
  5. package/dist/context.js +21 -0
  6. package/dist/credentials.d.ts +7 -0
  7. package/dist/credentials.js +59 -0
  8. package/dist/server.d.ts +2 -0
  9. package/dist/server.js +47 -0
  10. package/dist/setupCredentials.d.ts +2 -0
  11. package/dist/setupCredentials.js +151 -0
  12. package/dist/trustedDeviceKeyStore.d.ts +3 -0
  13. package/dist/trustedDeviceKeyStore.js +34 -0
  14. package/node_modules/@sendsafely/mcp-tools-core/LICENSE +201 -0
  15. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.d.ts +51 -0
  16. package/node_modules/@sendsafely/mcp-tools-core/dist/approval.js +148 -0
  17. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.d.ts +5 -0
  18. package/node_modules/@sendsafely/mcp-tools-core/dist/constants.js +8 -0
  19. package/node_modules/@sendsafely/mcp-tools-core/dist/context.d.ts +25 -0
  20. package/node_modules/@sendsafely/mcp-tools-core/dist/context.js +16 -0
  21. package/node_modules/@sendsafely/mcp-tools-core/dist/index.d.ts +18 -0
  22. package/node_modules/@sendsafely/mcp-tools-core/dist/index.js +17 -0
  23. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.d.ts +1 -0
  24. package/node_modules/@sendsafely/mcp-tools-core/dist/instructions.js +17 -0
  25. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.d.ts +3 -0
  26. package/node_modules/@sendsafely/mcp-tools-core/dist/jsonResult.js +15 -0
  27. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.d.ts +42 -0
  28. package/node_modules/@sendsafely/mcp-tools-core/dist/recipientAddContext.js +182 -0
  29. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.d.ts +2 -0
  30. package/node_modules/@sendsafely/mcp-tools-core/dist/runTool.js +22 -0
  31. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.d.ts +17 -0
  32. package/node_modules/@sendsafely/mcp-tools-core/dist/safeHandler.js +32 -0
  33. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.d.ts +17 -0
  34. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/clientFactory.js +29 -0
  35. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.d.ts +9 -0
  36. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/oauthError.js +34 -0
  37. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.d.ts +53 -0
  38. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/sdkPromise.js +462 -0
  39. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.d.ts +6 -0
  40. package/node_modules/@sendsafely/mcp-tools-core/dist/sdk/signedFetch.js +28 -0
  41. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.d.ts +6 -0
  42. package/node_modules/@sendsafely/mcp-tools-core/dist/store/keyStore.js +1 -0
  43. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.d.ts +18 -0
  44. package/node_modules/@sendsafely/mcp-tools-core/dist/store/packageSecretCache.js +39 -0
  45. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.d.ts +9 -0
  46. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/createDirectory.js +53 -0
  47. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.d.ts +10 -0
  48. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteDirectory.js +46 -0
  49. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.d.ts +11 -0
  50. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/deleteFile.js +53 -0
  51. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.d.ts +8 -0
  52. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getActivityLog.js +44 -0
  53. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.d.ts +12 -0
  54. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getDirectory.js +51 -0
  55. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.d.ts +5 -0
  56. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getEnterpriseInfo.js +27 -0
  57. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.d.ts +9 -0
  58. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getFileInformation.js +34 -0
  59. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.d.ts +7 -0
  60. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getPackageInformation.js +41 -0
  61. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.d.ts +5 -0
  62. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getReceivedPackages.js +54 -0
  63. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.d.ts +8 -0
  64. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getRecipient.js +30 -0
  65. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.d.ts +7 -0
  66. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getSentPackages.js +84 -0
  67. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.d.ts +5 -0
  68. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/getWorkspaces.js +114 -0
  69. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.d.ts +46 -0
  70. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/index.js +92 -0
  71. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.d.ts +9 -0
  72. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/moveDirectory.js +39 -0
  73. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.d.ts +8 -0
  74. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/removeRecipient.js +34 -0
  75. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.d.ts +9 -0
  76. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/renameDirectory.js +34 -0
  77. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.d.ts +10 -0
  78. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/setRecipientPhoneNumber.js +40 -0
  79. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.d.ts +9 -0
  80. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addPackageMessage.js +37 -0
  81. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.d.ts +9 -0
  82. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipient.js +109 -0
  83. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.d.ts +11 -0
  84. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientWithSms.js +115 -0
  85. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.d.ts +9 -0
  86. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/addRecipientsBulk.js +110 -0
  87. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.d.ts +6 -0
  88. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createPackage.js +65 -0
  89. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.d.ts +10 -0
  90. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/createWorkspace.js +107 -0
  91. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.d.ts +10 -0
  92. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/deletePackage.js +39 -0
  93. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.d.ts +12 -0
  94. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadFileFromDirectory.js +91 -0
  95. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.d.ts +12 -0
  96. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/downloadPackageFiles.js +205 -0
  97. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.d.ts +9 -0
  98. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizePackage.js +111 -0
  99. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.d.ts +9 -0
  100. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/finalizeUndisclosedPackage.js +57 -0
  101. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.d.ts +10 -0
  102. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/generateTrustedDeviceKeypair.js +75 -0
  103. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.d.ts +8 -0
  104. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageInformationFromLink.js +50 -0
  105. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.d.ts +11 -0
  106. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageKeycode.js +120 -0
  107. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.d.ts +9 -0
  108. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/getPackageMessage.js +59 -0
  109. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.d.ts +5 -0
  110. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/listDownloadedFiles.js +71 -0
  111. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.d.ts +8 -0
  112. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/readDownloadedFile.js +176 -0
  113. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.d.ts +12 -0
  114. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/stdio/uploadFile.js +69 -0
  115. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.d.ts +9 -0
  116. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateFile.js +38 -0
  117. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.d.ts +14 -0
  118. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updatePackage.js +122 -0
  119. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.d.ts +9 -0
  120. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/updateRecipientRole.js +45 -0
  121. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.d.ts +5 -0
  122. package/node_modules/@sendsafely/mcp-tools-core/dist/tools/verifyCredentials.js +27 -0
  123. package/node_modules/@sendsafely/mcp-tools-core/dist/types/sendsafely.d.ts +432 -0
  124. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.d.ts +1 -0
  125. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageChecksum.js +7 -0
  126. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.d.ts +8 -0
  127. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageDir.js +50 -0
  128. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.d.ts +2 -0
  129. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/packageLink.js +4 -0
  130. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.d.ts +4 -0
  131. package/node_modules/@sendsafely/mcp-tools-core/dist/utils/sanitizeFilename.js +8 -0
  132. package/node_modules/@sendsafely/mcp-tools-core/package.json +40 -0
  133. package/npm-shrinkwrap.json +1632 -0
  134. package/package.json +58 -4
@@ -0,0 +1,50 @@
1
+ import { chmod, lstat, mkdir, realpath } from "node:fs/promises";
2
+ import path from "node:path";
3
+ const PACKAGE_ID_PATTERN = /^[A-Z0-9]{4}-[A-Z0-9]{4}$/;
4
+ export function assertSafePackageId(packageId) {
5
+ if (!PACKAGE_ID_PATTERN.test(packageId)) {
6
+ throw new Error("Refusing to use package id: expected the XXXX-XXXX format " +
7
+ "(uppercase letters and digits).");
8
+ }
9
+ return packageId;
10
+ }
11
+ export async function preparePackageDir(root, packageId) {
12
+ assertSafePackageId(packageId);
13
+ await mkdir(root, { recursive: true, mode: 0o700 });
14
+ const realRoot = await realpath(root);
15
+ const target = path.join(realRoot, packageId);
16
+ if (path.dirname(target) !== realRoot) {
17
+ throw new Error("Refusing to use package id: it resolves outside the download root.");
18
+ }
19
+ await mkdir(target, { recursive: true, mode: 0o700 });
20
+ const existing = await lstat(target);
21
+ if (!existing.isDirectory()) {
22
+ throw new Error(`Refusing to use '${target}': path exists and is not a real directory ` +
23
+ "(symlink or file). Remove it or point SENDSAFELY_DOWNLOAD_DIR at a " +
24
+ "dedicated directory.");
25
+ }
26
+ await chmod(target, 0o700);
27
+ if (typeof process.getuid === "function") {
28
+ const uid = process.getuid();
29
+ if (!isTrustedRoot(await lstat(realRoot), uid)) {
30
+ throw new Error(`Refusing to use download root '${realRoot}': it must be owned by ` +
31
+ "the running user and not writable by other local users. Point " +
32
+ "SENDSAFELY_DOWNLOAD_DIR at a directory you own and remove group " +
33
+ "and other write access (chmod go-w).");
34
+ }
35
+ if (!isPrivateToUser(await lstat(target), uid)) {
36
+ throw new Error(`Refusing to use '${target}': it must be owned by the running user ` +
37
+ "with owner-only permissions so decrypted plaintext is not readable " +
38
+ "by other local users.");
39
+ }
40
+ }
41
+ return target;
42
+ }
43
+ export function isTrustedRoot(stats, uid) {
44
+ if (stats.uid !== uid && stats.uid !== 0)
45
+ return false;
46
+ return (stats.mode & 0o022) === 0 || (stats.mode & 0o1000) !== 0;
47
+ }
48
+ export function isPrivateToUser(stats, uid) {
49
+ return stats.uid === uid && (stats.mode & 0o077) === 0;
50
+ }
@@ -0,0 +1,2 @@
1
+ import type { SendSafelyClient } from "../sdk/clientFactory.js";
2
+ export declare function buildKeyedLink(client: SendSafelyClient, packageCode: string, keyCode: string): string;
@@ -0,0 +1,4 @@
1
+ export function buildKeyedLink(client, packageCode, keyCode) {
2
+ const base = client.url.replace(/\/+$/, "");
3
+ return `${base}/receive/?packageCode=${packageCode}#keyCode=${keyCode}`;
4
+ }
@@ -0,0 +1,4 @@
1
+ export declare const UNSAFE_FILENAME_CHARS: RegExp;
2
+ export declare function sanitizeFilename(name: string): string;
3
+ export declare const PROMPT_UNSAFE_CHARS: RegExp;
4
+ export declare function sanitizeForPrompt(text: string): string;
@@ -0,0 +1,8 @@
1
+ export const UNSAFE_FILENAME_CHARS = /[<>:"/\\|?*\x00-\x1f\x7f]/g;
2
+ export function sanitizeFilename(name) {
3
+ return name.replace(UNSAFE_FILENAME_CHARS, "_");
4
+ }
5
+ export const PROMPT_UNSAFE_CHARS = /[\x00-\x1f\x7f\u200e\u200f\u202a-\u202e\u2066-\u2069]/g;
6
+ export function sanitizeForPrompt(text) {
7
+ return text.replace(/[\r\n\t]+/g, " ").replace(PROMPT_UNSAFE_CHARS, "");
8
+ }
@@ -0,0 +1,40 @@
1
+ {
2
+ "name": "@sendsafely/mcp-tools-core",
3
+ "version": "1.0.5",
4
+ "license": "Apache-2.0",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "default": "./dist/index.js"
12
+ }
13
+ },
14
+ "files": [
15
+ "dist",
16
+ "!dist/**/*.map"
17
+ ],
18
+ "stdioPrune": [
19
+ "dist/http",
20
+ "dist/tools/http"
21
+ ],
22
+ "scripts": {
23
+ "build": "tsc -p tsconfig.build.json && node ../../scripts/finish-tools-core-build.mjs",
24
+ "build:publish": "tsc -p tsconfig.publish.json && node ../../scripts/finish-tools-core-build.mjs --strip-comments",
25
+ "typecheck": "tsc --noEmit -p tsconfig.json",
26
+ "test": "vitest run",
27
+ "lint": "eslint --config ../../eslint.config.mjs src tests"
28
+ },
29
+ "dependencies": {
30
+ "@modelcontextprotocol/sdk": "1.32.1",
31
+ "@sendsafely/sendsafely": "4.0.1",
32
+ "mime-types": "3.0.2",
33
+ "pdf-to-png-converter": "4.2.1",
34
+ "zod": "4.6.7"
35
+ },
36
+ "devDependencies": {
37
+ "@types/mime-types": "3.0.1",
38
+ "@types/node": "24.12.2"
39
+ }
40
+ }