@tinycloud/mcp 0.1.0-beta.2

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.
@@ -0,0 +1,320 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/server.ts
21
+ var server_exports = {};
22
+ __export(server_exports, {
23
+ MCP_SERVER_NAME: () => MCP_SERVER_NAME,
24
+ MCP_VERSION: () => MCP_VERSION,
25
+ createTinyCloudMcpServer: () => createTinyCloudMcpServer,
26
+ serveTinyCloudMcp: () => serveTinyCloudMcp
27
+ });
28
+ module.exports = __toCommonJS(server_exports);
29
+ var import_server2 = require("@modelcontextprotocol/server");
30
+ var import_stdio = require("@modelcontextprotocol/server/stdio");
31
+
32
+ // src/tools.ts
33
+ var import_node_module = require("module");
34
+ var import_node_path = require("path");
35
+ var import_server = require("@modelcontextprotocol/server");
36
+ var import_ajv = require("@modelcontextprotocol/server/validators/ajv");
37
+ var import_operations = require("@tinycloud/operations");
38
+
39
+ // src/results.ts
40
+ function toMcpToolResult(result) {
41
+ const canonical = isCanonicalOperationResult(result) ? result : {
42
+ status: "error",
43
+ operation: {},
44
+ context: {},
45
+ error: { code: "INTERNAL_ERROR" }
46
+ };
47
+ return {
48
+ content: [{ type: "text", text: resultSummary(canonical.status) }],
49
+ structuredContent: canonical
50
+ };
51
+ }
52
+ function isCanonicalOperationResult(value) {
53
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
54
+ const status = value.status;
55
+ return status === "ok" || status === "authority_required" || status === "setup_required" || status === "error";
56
+ }
57
+ function resultSummary(status) {
58
+ switch (status) {
59
+ case "ok":
60
+ return "TinyCloud operation completed; use the structured result.";
61
+ case "authority_required":
62
+ return "TinyCloud authority is required; use the structured request and approval action.";
63
+ case "setup_required":
64
+ return "TinyCloud setup is required; use the structured setup action.";
65
+ case "error":
66
+ return "TinyCloud operation failed; use the structured error.";
67
+ }
68
+ }
69
+
70
+ // src/tools.ts
71
+ var import_meta = {};
72
+ function invocationTargetForMcp(selection) {
73
+ return {
74
+ profile: selection.profile,
75
+ ...selection.explicitProfile && selection.allowOwnerProfile ? { allowOwnerProfile: true } : {}
76
+ };
77
+ }
78
+ var packageRequire = (0, import_node_module.createRequire)(
79
+ typeof __dirname === "string" ? (0, import_node_path.join)(__dirname, "tools.cjs") : import_meta.url
80
+ );
81
+ var generatedCatalog = packageRequire(
82
+ "@tinycloud/operations/operations.json"
83
+ );
84
+ var TOOL_BINDINGS = [
85
+ {
86
+ name: "tinycloud_status",
87
+ operationId: "tinycloud.status.get",
88
+ operationVersion: 1,
89
+ readOnlyHint: true,
90
+ idempotentHint: true,
91
+ openWorldHint: false
92
+ },
93
+ {
94
+ name: "tinycloud_auth_status",
95
+ operationId: "tinycloud.auth.status",
96
+ operationVersion: 1,
97
+ readOnlyHint: true,
98
+ idempotentHint: true,
99
+ openWorldHint: false
100
+ },
101
+ {
102
+ name: "tinycloud_auth_capabilities",
103
+ operationId: "tinycloud.auth.capabilities",
104
+ operationVersion: 1,
105
+ readOnlyHint: true,
106
+ idempotentHint: true,
107
+ openWorldHint: false
108
+ },
109
+ {
110
+ name: "tinycloud_auth_request",
111
+ operationId: "tinycloud.auth.request",
112
+ operationVersion: 1,
113
+ readOnlyHint: false,
114
+ idempotentHint: true,
115
+ openWorldHint: false
116
+ },
117
+ {
118
+ name: "tinycloud_auth_import",
119
+ operationId: "tinycloud.auth.import",
120
+ operationVersion: 1,
121
+ readOnlyHint: false,
122
+ idempotentHint: true,
123
+ openWorldHint: false
124
+ },
125
+ {
126
+ name: "tinycloud_account_spaces_list",
127
+ operationId: "tinycloud.account.spaces.list",
128
+ operationVersion: 1,
129
+ readOnlyHint: true,
130
+ idempotentHint: true,
131
+ openWorldHint: true
132
+ },
133
+ {
134
+ name: "tinycloud_account_applications_list",
135
+ operationId: "tinycloud.account.applications.list",
136
+ operationVersion: 1,
137
+ readOnlyHint: true,
138
+ idempotentHint: true,
139
+ openWorldHint: true
140
+ },
141
+ {
142
+ name: "tinycloud_kv_list",
143
+ operationId: "tinycloud.kv.list",
144
+ operationVersion: 1,
145
+ readOnlyHint: true,
146
+ idempotentHint: true,
147
+ openWorldHint: true
148
+ },
149
+ {
150
+ name: "tinycloud_kv_get",
151
+ operationId: "tinycloud.kv.get",
152
+ operationVersion: 1,
153
+ readOnlyHint: true,
154
+ idempotentHint: true,
155
+ openWorldHint: true
156
+ },
157
+ {
158
+ name: "tinycloud_secrets_get",
159
+ operationId: "tinycloud.secrets.get",
160
+ operationVersion: 1,
161
+ readOnlyHint: false,
162
+ idempotentHint: true,
163
+ openWorldHint: true
164
+ }
165
+ ];
166
+ function createJsonSchemaValidator() {
167
+ const ajv = new import_ajv.Ajv({ strict: false });
168
+ (0, import_ajv.addFormats)(ajv);
169
+ return new import_ajv.AjvJsonSchemaValidator(ajv);
170
+ }
171
+ function registerTinyCloudTools(server, selection, validator) {
172
+ const definitions = new Map(
173
+ generatedCatalog.operations.map((operation) => [
174
+ `${operation.id}@${operation.version}`,
175
+ operation
176
+ ])
177
+ );
178
+ for (const binding of TOOL_BINDINGS) {
179
+ const operation = definitions.get(`${binding.operationId}@${binding.operationVersion}`);
180
+ if (operation === void 0) {
181
+ throw new Error(`Generated operations catalog is missing ${binding.operationId}@${binding.operationVersion}.`);
182
+ }
183
+ const inputSchema = (0, import_server.fromJsonSchema)(
184
+ operation.input,
185
+ validator
186
+ );
187
+ const outputSchema = (0, import_server.fromJsonSchema)(
188
+ operation.result,
189
+ validator
190
+ );
191
+ const annotations = {
192
+ readOnlyHint: binding.readOnlyHint,
193
+ idempotentHint: binding.idempotentHint,
194
+ destructiveHint: false,
195
+ openWorldHint: binding.openWorldHint
196
+ };
197
+ server.registerTool(
198
+ binding.name,
199
+ {
200
+ title: operation.title,
201
+ description: operation.description,
202
+ inputSchema,
203
+ outputSchema,
204
+ annotations
205
+ },
206
+ async (input) => {
207
+ const result = await (0, import_operations.invokeOperation)(
208
+ binding.operationId,
209
+ binding.operationVersion,
210
+ invocationTargetForMcp(selection),
211
+ input
212
+ );
213
+ return toMcpToolResult(result);
214
+ }
215
+ );
216
+ }
217
+ }
218
+
219
+ // package.json
220
+ var package_default = {
221
+ name: "@tinycloud/mcp",
222
+ version: "0.1.0-beta.2",
223
+ description: "TinyCloud delegated operations MCP server",
224
+ author: "TinyCloud, Inc.",
225
+ license: "EGPL",
226
+ type: "module",
227
+ main: "dist/index.cjs",
228
+ module: "dist/index.js",
229
+ types: "dist/index.d.ts",
230
+ bin: {
231
+ "tinycloud-mcp": "./bin/tinycloud-mcp"
232
+ },
233
+ exports: {
234
+ ".": {
235
+ types: "./dist/index.d.ts",
236
+ import: "./dist/index.js",
237
+ require: "./dist/index.cjs"
238
+ },
239
+ "./server": {
240
+ types: "./dist/server.d.ts",
241
+ import: "./dist/server.js",
242
+ require: "./dist/server.cjs"
243
+ },
244
+ "./tools": {
245
+ types: "./dist/tools.d.ts",
246
+ import: "./dist/tools.js",
247
+ require: "./dist/tools.cjs"
248
+ },
249
+ "./results": {
250
+ types: "./dist/results.d.ts",
251
+ import: "./dist/results.js",
252
+ require: "./dist/results.cjs"
253
+ }
254
+ },
255
+ files: [
256
+ "dist",
257
+ "bin",
258
+ "generated",
259
+ "skills"
260
+ ],
261
+ engines: {
262
+ node: ">=20"
263
+ },
264
+ scripts: {
265
+ build: "tsup",
266
+ clean: "rm -rf dist",
267
+ test: "bun run build && bun scripts/test.ts && bun run check:generated",
268
+ "test:stdio": "bun run build && bun test src/stdio.test.ts",
269
+ typecheck: "tsc -p tsconfig.json",
270
+ generate: "bun scripts/generate.ts",
271
+ "check:generated": "bun scripts/generate.ts --check"
272
+ },
273
+ dependencies: {
274
+ "@modelcontextprotocol/server": "2.0.0-beta.4",
275
+ "@tinycloud/operations": "0.1.0-beta.2"
276
+ },
277
+ devDependencies: {
278
+ "@modelcontextprotocol/client": "2.0.0-beta.4",
279
+ "@types/node": "^20",
280
+ tsup: "^8.0.0",
281
+ typescript: "^5.9.3"
282
+ },
283
+ repository: {
284
+ type: "git",
285
+ url: "https://github.com/tinycloudlabs/web-sdk"
286
+ }
287
+ };
288
+
289
+ // src/version.ts
290
+ var MCP_VERSION = package_default.version;
291
+
292
+ // src/server.ts
293
+ var MCP_SERVER_NAME = "tinycloud-mcp";
294
+ function createTinyCloudMcpServer(selection) {
295
+ const validator = createJsonSchemaValidator();
296
+ const server = new import_server2.McpServer(
297
+ { name: MCP_SERVER_NAME, version: MCP_VERSION },
298
+ { jsonSchemaValidator: validator }
299
+ );
300
+ registerTinyCloudTools(server, selection, validator);
301
+ return server;
302
+ }
303
+ function serveTinyCloudMcp(selection) {
304
+ return (0, import_stdio.serveStdio)(
305
+ () => createTinyCloudMcpServer(selection),
306
+ { onerror: () => writeBoundedDiagnostic("MCP transport error") }
307
+ );
308
+ }
309
+ function writeBoundedDiagnostic(message) {
310
+ process.stderr.write(`[tinycloud-mcp] ${message}
311
+ `);
312
+ }
313
+ // Annotate the CommonJS export names for ESM import in node:
314
+ 0 && (module.exports = {
315
+ MCP_SERVER_NAME,
316
+ MCP_VERSION,
317
+ createTinyCloudMcpServer,
318
+ serveTinyCloudMcp
319
+ });
320
+ //# sourceMappingURL=server.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server.ts","../src/tools.ts","../src/results.ts","../package.json","../src/version.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/server\";\nimport { serveStdio, type StdioServerHandle } from \"@modelcontextprotocol/server/stdio\";\n\nimport { createJsonSchemaValidator, registerTinyCloudTools, type McpStartupSelection } from \"./tools.js\";\nimport { MCP_VERSION } from \"./version.js\";\n\nexport const MCP_SERVER_NAME = \"tinycloud-mcp\";\nexport { MCP_VERSION } from \"./version.js\";\nexport function createTinyCloudMcpServer(selection: McpStartupSelection): McpServer {\n const validator = createJsonSchemaValidator();\n const server = new McpServer(\n { name: MCP_SERVER_NAME, version: MCP_VERSION },\n { jsonSchemaValidator: validator },\n );\n registerTinyCloudTools(server, selection, validator);\n return server;\n}\n\n/** Start the only supported MCP transport: local stdio. */\nexport function serveTinyCloudMcp(selection: McpStartupSelection): StdioServerHandle {\n return serveStdio(\n () => createTinyCloudMcpServer(selection),\n { onerror: () => writeBoundedDiagnostic(\"MCP transport error\") },\n );\n}\n\nfunction writeBoundedDiagnostic(message: string): void {\n process.stderr.write(`[tinycloud-mcp] ${message}\\n`);\n}\n","import { createRequire } from \"node:module\";\nimport { join } from \"node:path\";\n\nimport { fromJsonSchema, type McpServer, type ToolAnnotations } from \"@modelcontextprotocol/server\";\nimport { addFormats, Ajv, AjvJsonSchemaValidator } from \"@modelcontextprotocol/server/validators/ajv\";\nimport { invokeOperation } from \"@tinycloud/operations\";\n\nimport { toMcpToolResult, type McpToolResult } from \"./results.js\";\n\nexport const TOOL_NAMES = [\n \"tinycloud_status\",\n \"tinycloud_auth_status\",\n \"tinycloud_auth_capabilities\",\n \"tinycloud_auth_request\",\n \"tinycloud_auth_import\",\n \"tinycloud_account_spaces_list\",\n \"tinycloud_account_applications_list\",\n \"tinycloud_kv_list\",\n \"tinycloud_kv_get\",\n \"tinycloud_secrets_get\",\n] as const;\n\nexport type ToolName = (typeof TOOL_NAMES)[number];\n\nexport interface McpStartupSelection {\n readonly profile: string;\n readonly explicitProfile: boolean;\n readonly allowOwnerProfile: boolean;\n}\n\nexport interface McpInvocationTarget {\n readonly profile: string;\n readonly allowOwnerProfile?: true;\n}\n\n/** Project one startup selection into the only owner-sensitive target shape. */\nexport function invocationTargetForMcp(\n selection: McpStartupSelection,\n): McpInvocationTarget {\n return {\n profile: selection.profile,\n ...(selection.explicitProfile && selection.allowOwnerProfile\n ? { allowOwnerProfile: true }\n : {}),\n };\n}\n\ninterface CatalogOperation {\n readonly id: string;\n readonly version: number;\n readonly title: string;\n readonly description: string;\n readonly input: Record<string, unknown>;\n readonly result: Record<string, unknown>;\n}\n\ninterface OperationsCatalog {\n readonly operations: readonly CatalogOperation[];\n}\n\n// The require anchor is this module, never the consumer entrypoint. In ESM\n// tsup preserves import.meta.url; in CJS it rewrites the same module-relative\n// anchor to the generated __filename, so both formats stay in MCP's package\n// dependency boundary.\nconst packageRequire = createRequire(\n typeof __dirname === \"string\" ? join(__dirname, \"tools.cjs\") : import.meta.url,\n);\nconst generatedCatalog = packageRequire(\n \"@tinycloud/operations/operations.json\",\n) as OperationsCatalog;\n\ninterface ToolBinding {\n readonly name: ToolName;\n readonly operationId: string;\n readonly operationVersion: number;\n readonly readOnlyHint: boolean;\n readonly idempotentHint: boolean;\n readonly openWorldHint: boolean;\n}\n\nconst TOOL_BINDINGS: readonly ToolBinding[] = [\n {\n name: \"tinycloud_status\",\n operationId: \"tinycloud.status.get\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: false,\n },\n {\n name: \"tinycloud_auth_status\",\n operationId: \"tinycloud.auth.status\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: false,\n },\n {\n name: \"tinycloud_auth_capabilities\",\n operationId: \"tinycloud.auth.capabilities\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: false,\n },\n {\n name: \"tinycloud_auth_request\",\n operationId: \"tinycloud.auth.request\",\n operationVersion: 1,\n readOnlyHint: false,\n idempotentHint: true,\n openWorldHint: false,\n },\n {\n name: \"tinycloud_auth_import\",\n operationId: \"tinycloud.auth.import\",\n operationVersion: 1,\n readOnlyHint: false,\n idempotentHint: true,\n openWorldHint: false,\n },\n {\n name: \"tinycloud_account_spaces_list\",\n operationId: \"tinycloud.account.spaces.list\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: true,\n },\n {\n name: \"tinycloud_account_applications_list\",\n operationId: \"tinycloud.account.applications.list\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: true,\n },\n {\n name: \"tinycloud_kv_list\",\n operationId: \"tinycloud.kv.list\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: true,\n },\n {\n name: \"tinycloud_kv_get\",\n operationId: \"tinycloud.kv.get\",\n operationVersion: 1,\n readOnlyHint: true,\n idempotentHint: true,\n openWorldHint: true,\n },\n {\n name: \"tinycloud_secrets_get\",\n operationId: \"tinycloud.secrets.get\",\n operationVersion: 1,\n readOnlyHint: false,\n idempotentHint: true,\n openWorldHint: true,\n },\n] as const;\n\nexport function createJsonSchemaValidator(): AjvJsonSchemaValidator {\n const ajv = new Ajv({ strict: false });\n addFormats(ajv);\n return new AjvJsonSchemaValidator(ajv);\n}\n\nexport function registerTinyCloudTools(\n server: McpServer,\n selection: McpStartupSelection,\n validator: AjvJsonSchemaValidator,\n): void {\n const definitions = new Map(\n generatedCatalog.operations.map((operation) => [\n `${operation.id}@${operation.version}`,\n operation,\n ]),\n );\n\n for (const binding of TOOL_BINDINGS) {\n const operation = definitions.get(`${binding.operationId}@${binding.operationVersion}`);\n if (operation === undefined) {\n throw new Error(`Generated operations catalog is missing ${binding.operationId}@${binding.operationVersion}.`);\n }\n\n const inputSchema = fromJsonSchema(\n operation.input as Parameters<typeof fromJsonSchema>[0],\n validator,\n );\n const outputSchema = fromJsonSchema(\n operation.result as unknown as Parameters<typeof fromJsonSchema>[0],\n validator,\n );\n const annotations: ToolAnnotations = {\n readOnlyHint: binding.readOnlyHint,\n idempotentHint: binding.idempotentHint,\n destructiveHint: false,\n openWorldHint: binding.openWorldHint,\n };\n\n server.registerTool(\n binding.name,\n {\n title: operation.title,\n description: operation.description,\n inputSchema,\n outputSchema,\n annotations,\n },\n async (input: unknown): Promise<McpToolResult> => {\n const result = await invokeOperation(\n binding.operationId,\n binding.operationVersion,\n invocationTargetForMcp(selection),\n input,\n );\n return toMcpToolResult(result);\n },\n );\n }\n}\n\nexport function toolBindingsForTest(): readonly ToolBinding[] {\n return TOOL_BINDINGS;\n}\n","/**\n * MCP has one structured result channel for a TinyCloud operation. Text is a\n * fixed, non-sensitive status line; it never serializes the operation result.\n */\nexport interface CanonicalOperationResult {\n readonly status: \"ok\" | \"authority_required\" | \"setup_required\" | \"error\";\n readonly [key: string]: unknown;\n}\n\nexport interface McpToolResult extends CallToolResult {\n readonly content: [{ readonly type: \"text\"; readonly text: string }];\n readonly structuredContent: CanonicalOperationResult;\n}\n\nexport function toMcpToolResult(result: unknown): McpToolResult {\n const canonical: CanonicalOperationResult = isCanonicalOperationResult(result)\n ? result\n : {\n status: \"error\",\n operation: {},\n context: {},\n error: { code: \"INTERNAL_ERROR\" },\n };\n\n return {\n content: [{ type: \"text\", text: resultSummary(canonical.status) }],\n structuredContent: canonical,\n };\n}\n\n/** The canonical envelope immediately before MCP protocol serialization. */\nexport function canonicalMcpAdapterResult(result: unknown): CanonicalOperationResult {\n return toMcpToolResult(result).structuredContent;\n}\n\nfunction isCanonicalOperationResult(value: unknown): value is CanonicalOperationResult {\n if (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n const status = (value as { status?: unknown }).status;\n return status === \"ok\" ||\n status === \"authority_required\" ||\n status === \"setup_required\" ||\n status === \"error\";\n}\n\nfunction resultSummary(status: CanonicalOperationResult[\"status\"]): string {\n switch (status) {\n case \"ok\":\n return \"TinyCloud operation completed; use the structured result.\";\n case \"authority_required\":\n return \"TinyCloud authority is required; use the structured request and approval action.\";\n case \"setup_required\":\n return \"TinyCloud setup is required; use the structured setup action.\";\n case \"error\":\n return \"TinyCloud operation failed; use the structured error.\";\n }\n}\nimport type { CallToolResult } from \"@modelcontextprotocol/server\";\n","{\n \"name\": \"@tinycloud/mcp\",\n \"version\": \"0.1.0-beta.2\",\n \"description\": \"TinyCloud delegated operations MCP server\",\n \"author\": \"TinyCloud, Inc.\",\n \"license\": \"EGPL\",\n \"type\": \"module\",\n \"main\": \"dist/index.cjs\",\n \"module\": \"dist/index.js\",\n \"types\": \"dist/index.d.ts\",\n \"bin\": {\n \"tinycloud-mcp\": \"./bin/tinycloud-mcp\"\n },\n \"exports\": {\n \".\": {\n \"types\": \"./dist/index.d.ts\",\n \"import\": \"./dist/index.js\",\n \"require\": \"./dist/index.cjs\"\n },\n \"./server\": {\n \"types\": \"./dist/server.d.ts\",\n \"import\": \"./dist/server.js\",\n \"require\": \"./dist/server.cjs\"\n },\n \"./tools\": {\n \"types\": \"./dist/tools.d.ts\",\n \"import\": \"./dist/tools.js\",\n \"require\": \"./dist/tools.cjs\"\n },\n \"./results\": {\n \"types\": \"./dist/results.d.ts\",\n \"import\": \"./dist/results.js\",\n \"require\": \"./dist/results.cjs\"\n }\n },\n \"files\": [\n \"dist\",\n \"bin\",\n \"generated\",\n \"skills\"\n ],\n \"engines\": {\n \"node\": \">=20\"\n },\n \"scripts\": {\n \"build\": \"tsup\",\n \"clean\": \"rm -rf dist\",\n \"test\": \"bun run build && bun scripts/test.ts && bun run check:generated\",\n \"test:stdio\": \"bun run build && bun test src/stdio.test.ts\",\n \"typecheck\": \"tsc -p tsconfig.json\",\n \"generate\": \"bun scripts/generate.ts\",\n \"check:generated\": \"bun scripts/generate.ts --check\"\n },\n \"dependencies\": {\n \"@modelcontextprotocol/server\": \"2.0.0-beta.4\",\n \"@tinycloud/operations\": \"0.1.0-beta.2\"\n },\n \"devDependencies\": {\n \"@modelcontextprotocol/client\": \"2.0.0-beta.4\",\n \"@types/node\": \"^20\",\n \"tsup\": \"^8.0.0\",\n \"typescript\": \"^5.9.3\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/tinycloudlabs/web-sdk\"\n }\n}\n","import packageMetadata from \"../package.json\";\n\nexport const MCP_VERSION = packageMetadata.version;\n"],"mappings":"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","names":["import_server"]}
@@ -0,0 +1,14 @@
1
+ import { McpServer } from '@modelcontextprotocol/server';
2
+ import { StdioServerHandle } from '@modelcontextprotocol/server/stdio';
3
+ import { McpStartupSelection } from './tools.cjs';
4
+ import '@modelcontextprotocol/server/validators/ajv';
5
+
6
+ declare const MCP_VERSION: string;
7
+
8
+ declare const MCP_SERVER_NAME = "tinycloud-mcp";
9
+
10
+ declare function createTinyCloudMcpServer(selection: McpStartupSelection): McpServer;
11
+ /** Start the only supported MCP transport: local stdio. */
12
+ declare function serveTinyCloudMcp(selection: McpStartupSelection): StdioServerHandle;
13
+
14
+ export { MCP_SERVER_NAME, MCP_VERSION, createTinyCloudMcpServer, serveTinyCloudMcp };
@@ -0,0 +1,14 @@
1
+ import { McpServer } from '@modelcontextprotocol/server';
2
+ import { StdioServerHandle } from '@modelcontextprotocol/server/stdio';
3
+ import { McpStartupSelection } from './tools.js';
4
+ import '@modelcontextprotocol/server/validators/ajv';
5
+
6
+ declare const MCP_VERSION: string;
7
+
8
+ declare const MCP_SERVER_NAME = "tinycloud-mcp";
9
+
10
+ declare function createTinyCloudMcpServer(selection: McpStartupSelection): McpServer;
11
+ /** Start the only supported MCP transport: local stdio. */
12
+ declare function serveTinyCloudMcp(selection: McpStartupSelection): StdioServerHandle;
13
+
14
+ export { MCP_SERVER_NAME, MCP_VERSION, createTinyCloudMcpServer, serveTinyCloudMcp };
package/dist/server.js ADDED
@@ -0,0 +1,291 @@
1
+ // src/server.ts
2
+ import { McpServer } from "@modelcontextprotocol/server";
3
+ import { serveStdio } from "@modelcontextprotocol/server/stdio";
4
+
5
+ // src/tools.ts
6
+ import { createRequire } from "module";
7
+ import { join } from "path";
8
+ import { fromJsonSchema } from "@modelcontextprotocol/server";
9
+ import { addFormats, Ajv, AjvJsonSchemaValidator } from "@modelcontextprotocol/server/validators/ajv";
10
+ import { invokeOperation } from "@tinycloud/operations";
11
+
12
+ // src/results.ts
13
+ function toMcpToolResult(result) {
14
+ const canonical = isCanonicalOperationResult(result) ? result : {
15
+ status: "error",
16
+ operation: {},
17
+ context: {},
18
+ error: { code: "INTERNAL_ERROR" }
19
+ };
20
+ return {
21
+ content: [{ type: "text", text: resultSummary(canonical.status) }],
22
+ structuredContent: canonical
23
+ };
24
+ }
25
+ function isCanonicalOperationResult(value) {
26
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
27
+ const status = value.status;
28
+ return status === "ok" || status === "authority_required" || status === "setup_required" || status === "error";
29
+ }
30
+ function resultSummary(status) {
31
+ switch (status) {
32
+ case "ok":
33
+ return "TinyCloud operation completed; use the structured result.";
34
+ case "authority_required":
35
+ return "TinyCloud authority is required; use the structured request and approval action.";
36
+ case "setup_required":
37
+ return "TinyCloud setup is required; use the structured setup action.";
38
+ case "error":
39
+ return "TinyCloud operation failed; use the structured error.";
40
+ }
41
+ }
42
+
43
+ // src/tools.ts
44
+ function invocationTargetForMcp(selection) {
45
+ return {
46
+ profile: selection.profile,
47
+ ...selection.explicitProfile && selection.allowOwnerProfile ? { allowOwnerProfile: true } : {}
48
+ };
49
+ }
50
+ var packageRequire = createRequire(
51
+ typeof __dirname === "string" ? join(__dirname, "tools.cjs") : import.meta.url
52
+ );
53
+ var generatedCatalog = packageRequire(
54
+ "@tinycloud/operations/operations.json"
55
+ );
56
+ var TOOL_BINDINGS = [
57
+ {
58
+ name: "tinycloud_status",
59
+ operationId: "tinycloud.status.get",
60
+ operationVersion: 1,
61
+ readOnlyHint: true,
62
+ idempotentHint: true,
63
+ openWorldHint: false
64
+ },
65
+ {
66
+ name: "tinycloud_auth_status",
67
+ operationId: "tinycloud.auth.status",
68
+ operationVersion: 1,
69
+ readOnlyHint: true,
70
+ idempotentHint: true,
71
+ openWorldHint: false
72
+ },
73
+ {
74
+ name: "tinycloud_auth_capabilities",
75
+ operationId: "tinycloud.auth.capabilities",
76
+ operationVersion: 1,
77
+ readOnlyHint: true,
78
+ idempotentHint: true,
79
+ openWorldHint: false
80
+ },
81
+ {
82
+ name: "tinycloud_auth_request",
83
+ operationId: "tinycloud.auth.request",
84
+ operationVersion: 1,
85
+ readOnlyHint: false,
86
+ idempotentHint: true,
87
+ openWorldHint: false
88
+ },
89
+ {
90
+ name: "tinycloud_auth_import",
91
+ operationId: "tinycloud.auth.import",
92
+ operationVersion: 1,
93
+ readOnlyHint: false,
94
+ idempotentHint: true,
95
+ openWorldHint: false
96
+ },
97
+ {
98
+ name: "tinycloud_account_spaces_list",
99
+ operationId: "tinycloud.account.spaces.list",
100
+ operationVersion: 1,
101
+ readOnlyHint: true,
102
+ idempotentHint: true,
103
+ openWorldHint: true
104
+ },
105
+ {
106
+ name: "tinycloud_account_applications_list",
107
+ operationId: "tinycloud.account.applications.list",
108
+ operationVersion: 1,
109
+ readOnlyHint: true,
110
+ idempotentHint: true,
111
+ openWorldHint: true
112
+ },
113
+ {
114
+ name: "tinycloud_kv_list",
115
+ operationId: "tinycloud.kv.list",
116
+ operationVersion: 1,
117
+ readOnlyHint: true,
118
+ idempotentHint: true,
119
+ openWorldHint: true
120
+ },
121
+ {
122
+ name: "tinycloud_kv_get",
123
+ operationId: "tinycloud.kv.get",
124
+ operationVersion: 1,
125
+ readOnlyHint: true,
126
+ idempotentHint: true,
127
+ openWorldHint: true
128
+ },
129
+ {
130
+ name: "tinycloud_secrets_get",
131
+ operationId: "tinycloud.secrets.get",
132
+ operationVersion: 1,
133
+ readOnlyHint: false,
134
+ idempotentHint: true,
135
+ openWorldHint: true
136
+ }
137
+ ];
138
+ function createJsonSchemaValidator() {
139
+ const ajv = new Ajv({ strict: false });
140
+ addFormats(ajv);
141
+ return new AjvJsonSchemaValidator(ajv);
142
+ }
143
+ function registerTinyCloudTools(server, selection, validator) {
144
+ const definitions = new Map(
145
+ generatedCatalog.operations.map((operation) => [
146
+ `${operation.id}@${operation.version}`,
147
+ operation
148
+ ])
149
+ );
150
+ for (const binding of TOOL_BINDINGS) {
151
+ const operation = definitions.get(`${binding.operationId}@${binding.operationVersion}`);
152
+ if (operation === void 0) {
153
+ throw new Error(`Generated operations catalog is missing ${binding.operationId}@${binding.operationVersion}.`);
154
+ }
155
+ const inputSchema = fromJsonSchema(
156
+ operation.input,
157
+ validator
158
+ );
159
+ const outputSchema = fromJsonSchema(
160
+ operation.result,
161
+ validator
162
+ );
163
+ const annotations = {
164
+ readOnlyHint: binding.readOnlyHint,
165
+ idempotentHint: binding.idempotentHint,
166
+ destructiveHint: false,
167
+ openWorldHint: binding.openWorldHint
168
+ };
169
+ server.registerTool(
170
+ binding.name,
171
+ {
172
+ title: operation.title,
173
+ description: operation.description,
174
+ inputSchema,
175
+ outputSchema,
176
+ annotations
177
+ },
178
+ async (input) => {
179
+ const result = await invokeOperation(
180
+ binding.operationId,
181
+ binding.operationVersion,
182
+ invocationTargetForMcp(selection),
183
+ input
184
+ );
185
+ return toMcpToolResult(result);
186
+ }
187
+ );
188
+ }
189
+ }
190
+
191
+ // package.json
192
+ var package_default = {
193
+ name: "@tinycloud/mcp",
194
+ version: "0.1.0-beta.2",
195
+ description: "TinyCloud delegated operations MCP server",
196
+ author: "TinyCloud, Inc.",
197
+ license: "EGPL",
198
+ type: "module",
199
+ main: "dist/index.cjs",
200
+ module: "dist/index.js",
201
+ types: "dist/index.d.ts",
202
+ bin: {
203
+ "tinycloud-mcp": "./bin/tinycloud-mcp"
204
+ },
205
+ exports: {
206
+ ".": {
207
+ types: "./dist/index.d.ts",
208
+ import: "./dist/index.js",
209
+ require: "./dist/index.cjs"
210
+ },
211
+ "./server": {
212
+ types: "./dist/server.d.ts",
213
+ import: "./dist/server.js",
214
+ require: "./dist/server.cjs"
215
+ },
216
+ "./tools": {
217
+ types: "./dist/tools.d.ts",
218
+ import: "./dist/tools.js",
219
+ require: "./dist/tools.cjs"
220
+ },
221
+ "./results": {
222
+ types: "./dist/results.d.ts",
223
+ import: "./dist/results.js",
224
+ require: "./dist/results.cjs"
225
+ }
226
+ },
227
+ files: [
228
+ "dist",
229
+ "bin",
230
+ "generated",
231
+ "skills"
232
+ ],
233
+ engines: {
234
+ node: ">=20"
235
+ },
236
+ scripts: {
237
+ build: "tsup",
238
+ clean: "rm -rf dist",
239
+ test: "bun run build && bun scripts/test.ts && bun run check:generated",
240
+ "test:stdio": "bun run build && bun test src/stdio.test.ts",
241
+ typecheck: "tsc -p tsconfig.json",
242
+ generate: "bun scripts/generate.ts",
243
+ "check:generated": "bun scripts/generate.ts --check"
244
+ },
245
+ dependencies: {
246
+ "@modelcontextprotocol/server": "2.0.0-beta.4",
247
+ "@tinycloud/operations": "0.1.0-beta.2"
248
+ },
249
+ devDependencies: {
250
+ "@modelcontextprotocol/client": "2.0.0-beta.4",
251
+ "@types/node": "^20",
252
+ tsup: "^8.0.0",
253
+ typescript: "^5.9.3"
254
+ },
255
+ repository: {
256
+ type: "git",
257
+ url: "https://github.com/tinycloudlabs/web-sdk"
258
+ }
259
+ };
260
+
261
+ // src/version.ts
262
+ var MCP_VERSION = package_default.version;
263
+
264
+ // src/server.ts
265
+ var MCP_SERVER_NAME = "tinycloud-mcp";
266
+ function createTinyCloudMcpServer(selection) {
267
+ const validator = createJsonSchemaValidator();
268
+ const server = new McpServer(
269
+ { name: MCP_SERVER_NAME, version: MCP_VERSION },
270
+ { jsonSchemaValidator: validator }
271
+ );
272
+ registerTinyCloudTools(server, selection, validator);
273
+ return server;
274
+ }
275
+ function serveTinyCloudMcp(selection) {
276
+ return serveStdio(
277
+ () => createTinyCloudMcpServer(selection),
278
+ { onerror: () => writeBoundedDiagnostic("MCP transport error") }
279
+ );
280
+ }
281
+ function writeBoundedDiagnostic(message) {
282
+ process.stderr.write(`[tinycloud-mcp] ${message}
283
+ `);
284
+ }
285
+ export {
286
+ MCP_SERVER_NAME,
287
+ MCP_VERSION,
288
+ createTinyCloudMcpServer,
289
+ serveTinyCloudMcp
290
+ };
291
+ //# sourceMappingURL=server.js.map