@theorvane/type-mcp 0.2.0

package/dist/index.js

@@ -0,0 +1,318 @@
+import {
+  TypeMcpDefinitionError,
+  defaultInstanceResolver,
+  getMcpServerDefinition,
+  readMcpServerDefinition,
+  resolveMcpServerInstance,
+  storeMcpServerDefinition
+} from "./chunk-64DS4UNF.js";
+
+// src/compiler/create-mcp-server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/compiler/normalize-resource-prompt-result.ts
+import {
+  GetPromptResultSchema,
+  ReadResourceResultSchema
+} from "@modelcontextprotocol/sdk/types.js";
+function isRecord(result) {
+  return typeof result === "object" && result !== null;
+}
+function serializeResult(result) {
+  if (typeof result === "string") {
+    return result;
+  }
+  const json = JSON.stringify(result);
+  if (json === void 0) {
+    throw new TypeError("MCP handler result must be JSON-compatible");
+  }
+  return json;
+}
+function normalizeResourceResult(result, uri, mimeType) {
+  if (isRecord(result) && Array.isArray(result.contents)) {
+    const parsed = ReadResourceResultSchema.safeParse(result);
+    if (parsed.success) {
+      return parsed.data;
+    }
+  }
+  return {
+    contents: [
+      {
+        uri: uri.toString(),
+        text: serializeResult(result),
+        ...mimeType === void 0 ? {} : { mimeType }
+      }
+    ]
+  };
+}
+function normalizePromptResult(result) {
+  if (isRecord(result) && Array.isArray(result.messages)) {
+    const parsed = GetPromptResultSchema.safeParse(result);
+    if (parsed.success) {
+      return parsed.data;
+    }
+  }
+  return {
+    messages: [
+      {
+        role: "user",
+        content: { type: "text", text: serializeResult(result) }
+      }
+    ]
+  };
+}
+
+// src/compiler/normalize-tool-result.ts
+import {
+  CallToolResultSchema
+} from "@modelcontextprotocol/sdk/types.js";
+function isRecord2(result) {
+  return typeof result === "object" && result !== null;
+}
+function isMcpToolResultCandidate(result) {
+  return isRecord2(result) && (Array.isArray(result.content) || "structuredContent" in result || "isError" in result);
+}
+function normalizeToolResult(result) {
+  if (typeof result === "string") {
+    return { content: [{ type: "text", text: result }] };
+  }
+  if (isMcpToolResultCandidate(result)) {
+    const parsed = CallToolResultSchema.safeParse(result);
+    if (parsed.success) {
+      return parsed.data;
+    }
+  }
+  const json = JSON.stringify(result);
+  if (json === void 0) {
+    throw new TypeError("Tool result must be JSON-compatible");
+  }
+  return { content: [{ type: "text", text: json }] };
+}
+
+// src/compiler/create-mcp-server.ts
+async function createMcpServer(serverClass, resolver) {
+  const definition = readMcpServerDefinition(serverClass);
+  const instance = resolver ? await resolveMcpServerInstance(serverClass, resolver) : await resolveMcpServerInstance(
+    serverClass
+  );
+  const server = new McpServer({
+    name: definition.name,
+    version: definition.version
+  });
+  for (const tool of definition.tools) {
+    server.registerTool(
+      tool.name,
+      {
+        inputSchema: tool.input,
+        ...tool.description === void 0 ? {} : { description: tool.description }
+      },
+      async (input) => {
+        try {
+          const result = await invokeTool(instance, tool.methodName, input);
+          return normalizeToolResult(result);
+        } catch {
+          return {
+            content: [{ type: "text", text: "Tool execution failed" }],
+            isError: true
+          };
+        }
+      }
+    );
+  }
+  for (const resource of definition.resources) {
+    server.registerResource(
+      resource.name,
+      resource.uri,
+      {
+        ...resource.description === void 0 ? {} : { description: resource.description },
+        ...resource.mimeType === void 0 ? {} : { mimeType: resource.mimeType }
+      },
+      async (uri) => {
+        try {
+          const result = await invokeMethod(instance, resource.methodName, []);
+          return normalizeResourceResult(result, uri, resource.mimeType);
+        } catch {
+          return normalizeResourceResult(
+            "Resource execution failed",
+            uri,
+            resource.mimeType
+          );
+        }
+      }
+    );
+  }
+  for (const prompt of definition.prompts) {
+    server.registerPrompt(
+      prompt.name,
+      {
+        ...prompt.description === void 0 ? {} : { description: prompt.description }
+      },
+      async () => {
+        try {
+          const result = await invokeMethod(instance, prompt.methodName, []);
+          return normalizePromptResult(result);
+        } catch {
+          return normalizePromptResult("Prompt execution failed");
+        }
+      }
+    );
+  }
+  return server;
+}
+function invokeTool(instance, methodName, input) {
+  return invokeMethod(instance, methodName, [input]);
+}
+function invokeMethod(instance, methodName, arguments_) {
+  const method = Reflect.get(instance, methodName);
+  if (typeof method !== "function") {
+    throw new TypeError("Decorated MCP method is not callable");
+  }
+  return Reflect.apply(method, instance, arguments_);
+}
+
+// src/metadata/keys.ts
+var symbolWithMetadata = Symbol;
+if (symbolWithMetadata.metadata === void 0) {
+  Object.defineProperty(Symbol, "metadata", {
+    configurable: true,
+    value: /* @__PURE__ */ Symbol("Symbol.metadata")
+  });
+}
+var MCP_TOOLS_METADATA_KEY = /* @__PURE__ */ Symbol("type-mcp:tools");
+var MCP_RESOURCES_METADATA_KEY = /* @__PURE__ */ Symbol("type-mcp:resources");
+var MCP_PROMPTS_METADATA_KEY = /* @__PURE__ */ Symbol("type-mcp:prompts");
+
+// src/metadata/metadata.ts
+function hasOwnMetadata(metadata, key) {
+  return Object.prototype.hasOwnProperty.call(metadata, key);
+}
+function appendDefinition(metadata, key, definition) {
+  const existing = hasOwnMetadata(metadata, key) ? metadata[key] : void 0;
+  const definitions = Array.isArray(existing) ? existing : [];
+  Object.defineProperty(metadata, key, {
+    configurable: true,
+    enumerable: false,
+    value: [...definitions, definition],
+    writable: true
+  });
+}
+function readDefinitions(metadata, key) {
+  const definitions = hasOwnMetadata(metadata, key) ? metadata[key] : void 0;
+  return Array.isArray(definitions) ? [...definitions] : [];
+}
+function appendToolDefinition(metadata, definition) {
+  appendDefinition(metadata, MCP_TOOLS_METADATA_KEY, definition);
+}
+function appendResourceDefinition(metadata, definition) {
+  appendDefinition(metadata, MCP_RESOURCES_METADATA_KEY, definition);
+}
+function appendPromptDefinition(metadata, definition) {
+  appendDefinition(metadata, MCP_PROMPTS_METADATA_KEY, definition);
+}
+function readToolDefinitions(metadata) {
+  return readDefinitions(metadata, MCP_TOOLS_METADATA_KEY);
+}
+function readResourceDefinitions(metadata) {
+  return readDefinitions(
+    metadata,
+    MCP_RESOURCES_METADATA_KEY
+  );
+}
+function readPromptDefinitions(metadata) {
+  return readDefinitions(
+    metadata,
+    MCP_PROMPTS_METADATA_KEY
+  );
+}
+
+// src/decorators/mcp-prompt.ts
+function McpPrompt(options) {
+  return function(_value, context) {
+    const methodName = getMethodName(context);
+    appendPromptDefinition(context.metadata, {
+      name: options.name ?? methodName,
+      methodName,
+      description: options.description
+    });
+  };
+}
+function getMethodName(context) {
+  if (typeof context.name !== "string") {
+    throw new TypeError("MCP decorators require string-named methods");
+  }
+  return context.name;
+}
+
+// src/decorators/mcp-resource.ts
+function McpResource(options) {
+  return function(_value, context) {
+    const methodName = getMethodName2(context);
+    appendResourceDefinition(context.metadata, {
+      name: options.name ?? methodName,
+      methodName,
+      uri: options.uri,
+      mimeType: options.mimeType,
+      description: options.description
+    });
+  };
+}
+function getMethodName2(context) {
+  if (typeof context.name !== "string") {
+    throw new TypeError("MCP decorators require string-named methods");
+  }
+  return context.name;
+}
+
+// src/decorators/mcp-server.ts
+function McpServer2(options) {
+  return function(target, context) {
+    storeMcpServerDefinition(target, {
+      name: options.name,
+      version: options.version,
+      tools: readToolDefinitions(context.metadata),
+      resources: readResourceDefinitions(context.metadata),
+      prompts: readPromptDefinitions(context.metadata)
+    });
+  };
+}
+
+// src/decorators/mcp-tool.ts
+function McpTool(options) {
+  return function(_value, context) {
+    const methodName = getMethodName3(context);
+    appendToolDefinition(context.metadata, {
+      name: options.name ?? methodName,
+      methodName,
+      description: options.description,
+      input: options.input
+    });
+  };
+}
+function getMethodName3(context) {
+  if (typeof context.name !== "string") {
+    throw new TypeError("MCP decorators require string-named methods");
+  }
+  return context.name;
+}
+
+// src/transports/stdio.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+async function startStdioServer(server, options = {}) {
+  const transport = options.transportFactory?.() ?? new StdioServerTransport();
+  await server.connect(transport);
+  return { server, transport };
+}
+export {
+  McpPrompt,
+  McpResource,
+  McpServer2 as McpServer,
+  McpTool,
+  TypeMcpDefinitionError,
+  createMcpServer,
+  defaultInstanceResolver,
+  getMcpServerDefinition,
+  readMcpServerDefinition,
+  resolveMcpServerInstance,
+  startStdioServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compiler/create-mcp-server.ts","../src/compiler/normalize-resource-prompt-result.ts","../src/compiler/normalize-tool-result.ts","../src/metadata/keys.ts","../src/metadata/metadata.ts","../src/decorators/mcp-prompt.ts","../src/decorators/mcp-resource.ts","../src/decorators/mcp-server.ts","../src/decorators/mcp-tool.ts","../src/transports/stdio.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { readMcpServerDefinition } from \"../metadata/read-server-definition.js\";\nimport type { InstanceResolver } from \"../resolver/instance-resolver.js\";\nimport { resolveMcpServerInstance } from \"../resolver/resolve-server-instance.js\";\nimport type {\n\tMcpServerConstructor,\n\tZeroArgumentMcpServerConstructor,\n} from \"../types.js\";\nimport {\n\tnormalizePromptResult,\n\tnormalizeResourceResult,\n} from \"./normalize-resource-prompt-result.js\";\nimport { normalizeToolResult } from \"./normalize-tool-result.js\";\n\nexport async function createMcpServer<T extends object>(\n\tserverClass: ZeroArgumentMcpServerConstructor<T>,\n): Promise<McpServer>;\nexport async function createMcpServer<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\tresolver: InstanceResolver<T>,\n): Promise<McpServer>;\nexport async function createMcpServer<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\tresolver?: InstanceResolver<T>,\n): Promise<McpServer> {\n\tconst definition = readMcpServerDefinition(serverClass);\n\tconst instance = resolver\n\t\t? await resolveMcpServerInstance(serverClass, resolver)\n\t\t: await resolveMcpServerInstance(\n\t\t\t\tserverClass as ZeroArgumentMcpServerConstructor<T>,\n\t\t\t);\n\tconst server = new McpServer({\n\t\tname: definition.name,\n\t\tversion: definition.version,\n\t});\n\n\tfor (const tool of definition.tools) {\n\t\tserver.registerTool(\n\t\t\ttool.name,\n\t\t\t{\n\t\t\t\tinputSchema: tool.input,\n\t\t\t\t...(tool.description === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { description: tool.description }),\n\t\t\t},\n\t\t\tasync (input) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await invokeTool(instance, tool.methodName, input);\n\t\t\t\t\treturn normalizeToolResult(result);\n\t\t\t\t} catch {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"Tool execution failed\" }],\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\t}\n\n\tfor (const resource of definition.resources) {\n\t\tserver.registerResource(\n\t\t\tresource.name,\n\t\t\tresource.uri,\n\t\t\t{\n\t\t\t\t...(resource.description === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { description: resource.description }),\n\t\t\t\t...(resource.mimeType === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { mimeType: resource.mimeType }),\n\t\t\t},\n\t\t\tasync (uri) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await invokeMethod(instance, resource.methodName, []);\n\t\t\t\t\treturn normalizeResourceResult(result, uri, resource.mimeType);\n\t\t\t\t} catch {\n\t\t\t\t\treturn normalizeResourceResult(\n\t\t\t\t\t\t\"Resource execution failed\",\n\t\t\t\t\t\turi,\n\t\t\t\t\t\tresource.mimeType,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\t}\n\n\tfor (const prompt of definition.prompts) {\n\t\tserver.registerPrompt(\n\t\t\tprompt.name,\n\t\t\t{\n\t\t\t\t...(prompt.description === undefined\n\t\t\t\t\t? {}\n\t\t\t\t\t: { description: prompt.description }),\n\t\t\t},\n\t\t\tasync () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await invokeMethod(instance, prompt.methodName, []);\n\t\t\t\t\treturn normalizePromptResult(result);\n\t\t\t\t} catch {\n\t\t\t\t\treturn normalizePromptResult(\"Prompt execution failed\");\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\t}\n\n\treturn server;\n}\n\nfunction invokeTool(\n\tinstance: object,\n\tmethodName: string,\n\tinput: unknown,\n): unknown | Promise<unknown> {\n\treturn invokeMethod(instance, methodName, [input]);\n}\n\nfunction invokeMethod(\n\tinstance: object,\n\tmethodName: string,\n\targuments_: readonly unknown[],\n): unknown | Promise<unknown> {\n\tconst method = Reflect.get(instance, methodName);\n\tif (typeof method !== \"function\") {\n\t\tthrow new TypeError(\"Decorated MCP method is not callable\");\n\t}\n\n\treturn Reflect.apply(method, instance, arguments_);\n}\n","import {\n\ttype GetPromptResult,\n\tGetPromptResultSchema,\n\ttype ReadResourceResult,\n\tReadResourceResultSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\nfunction isRecord(result: unknown): result is Record<string, unknown> {\n\treturn typeof result === \"object\" && result !== null;\n}\n\nfunction serializeResult(result: unknown): string {\n\tif (typeof result === \"string\") {\n\t\treturn result;\n\t}\n\n\tconst json = JSON.stringify(result);\n\tif (json === undefined) {\n\t\tthrow new TypeError(\"MCP handler result must be JSON-compatible\");\n\t}\n\n\treturn json;\n}\n\nexport function normalizeResourceResult(\n\tresult: unknown,\n\turi: URL,\n\tmimeType: string | undefined,\n): ReadResourceResult {\n\tif (isRecord(result) && Array.isArray(result.contents)) {\n\t\tconst parsed = ReadResourceResultSchema.safeParse(result);\n\t\tif (parsed.success) {\n\t\t\treturn parsed.data;\n\t\t}\n\t}\n\n\treturn {\n\t\tcontents: [\n\t\t\t{\n\t\t\t\turi: uri.toString(),\n\t\t\t\ttext: serializeResult(result),\n\t\t\t\t...(mimeType === undefined ? {} : { mimeType }),\n\t\t\t},\n\t\t],\n\t};\n}\n\nexport function normalizePromptResult(result: unknown): GetPromptResult {\n\tif (isRecord(result) && Array.isArray(result.messages)) {\n\t\tconst parsed = GetPromptResultSchema.safeParse(result);\n\t\tif (parsed.success) {\n\t\t\treturn parsed.data;\n\t\t}\n\t}\n\n\treturn {\n\t\tmessages: [\n\t\t\t{\n\t\t\t\trole: \"user\",\n\t\t\t\tcontent: { type: \"text\", text: serializeResult(result) },\n\t\t\t},\n\t\t],\n\t};\n}\n","import {\n\ttype CallToolResult,\n\tCallToolResultSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\nfunction isRecord(result: unknown): result is Record<string, unknown> {\n\treturn typeof result === \"object\" && result !== null;\n}\n\nfunction isMcpToolResultCandidate(result: unknown): boolean {\n\treturn (\n\t\tisRecord(result) &&\n\t\t(Array.isArray(result.content) ||\n\t\t\t\"structuredContent\" in result ||\n\t\t\t\"isError\" in result)\n\t);\n}\n\nexport function normalizeToolResult(result: unknown): CallToolResult {\n\tif (typeof result === \"string\") {\n\t\treturn { content: [{ type: \"text\", text: result }] };\n\t}\n\n\tif (isMcpToolResultCandidate(result)) {\n\t\tconst parsed = CallToolResultSchema.safeParse(result);\n\t\tif (parsed.success) {\n\t\t\treturn parsed.data;\n\t\t}\n\t}\n\n\tconst json = JSON.stringify(result);\n\tif (json === undefined) {\n\t\tthrow new TypeError(\"Tool result must be JSON-compatible\");\n\t}\n\n\treturn { content: [{ type: \"text\", text: json }] };\n}\n","const symbolWithMetadata = Symbol as unknown as {\n\tmetadata?: symbol;\n};\n\nif (symbolWithMetadata.metadata === undefined) {\n\tObject.defineProperty(Symbol, \"metadata\", {\n\t\tconfigurable: true,\n\t\tvalue: Symbol(\"Symbol.metadata\"),\n\t});\n}\n\nexport const MCP_TOOLS_METADATA_KEY = Symbol(\"type-mcp:tools\");\nexport const MCP_RESOURCES_METADATA_KEY = Symbol(\"type-mcp:resources\");\nexport const MCP_PROMPTS_METADATA_KEY = Symbol(\"type-mcp:prompts\");\n","import type {\n\tMcpPromptDefinition,\n\tMcpResourceDefinition,\n\tMcpToolDefinition,\n} from \"../types.js\";\nimport {\n\tMCP_PROMPTS_METADATA_KEY,\n\tMCP_RESOURCES_METADATA_KEY,\n\tMCP_TOOLS_METADATA_KEY,\n} from \"./keys.js\";\n\nfunction hasOwnMetadata(metadata: DecoratorMetadata, key: symbol): boolean {\n\treturn Object.prototype.hasOwnProperty.call(metadata, key);\n}\n\nfunction appendDefinition<T>(\n\tmetadata: DecoratorMetadata,\n\tkey: symbol,\n\tdefinition: T,\n): void {\n\tconst existing = hasOwnMetadata(metadata, key) ? metadata[key] : undefined;\n\tconst definitions = Array.isArray(existing) ? existing : [];\n\n\tObject.defineProperty(metadata, key, {\n\t\tconfigurable: true,\n\t\tenumerable: false,\n\t\tvalue: [...definitions, definition],\n\t\twritable: true,\n\t});\n}\n\nfunction readDefinitions<T>(\n\tmetadata: DecoratorMetadata,\n\tkey: symbol,\n): readonly T[] {\n\tconst definitions = hasOwnMetadata(metadata, key) ? metadata[key] : undefined;\n\treturn Array.isArray(definitions) ? ([...definitions] as readonly T[]) : [];\n}\n\nexport function appendToolDefinition(\n\tmetadata: DecoratorMetadata,\n\tdefinition: McpToolDefinition,\n): void {\n\tappendDefinition(metadata, MCP_TOOLS_METADATA_KEY, definition);\n}\n\nexport function appendResourceDefinition(\n\tmetadata: DecoratorMetadata,\n\tdefinition: McpResourceDefinition,\n): void {\n\tappendDefinition(metadata, MCP_RESOURCES_METADATA_KEY, definition);\n}\n\nexport function appendPromptDefinition(\n\tmetadata: DecoratorMetadata,\n\tdefinition: McpPromptDefinition,\n): void {\n\tappendDefinition(metadata, MCP_PROMPTS_METADATA_KEY, definition);\n}\n\nexport function readToolDefinitions(\n\tmetadata: DecoratorMetadata,\n): readonly McpToolDefinition[] {\n\treturn readDefinitions<McpToolDefinition>(metadata, MCP_TOOLS_METADATA_KEY);\n}\n\nexport function readResourceDefinitions(\n\tmetadata: DecoratorMetadata,\n): readonly McpResourceDefinition[] {\n\treturn readDefinitions<McpResourceDefinition>(\n\t\tmetadata,\n\t\tMCP_RESOURCES_METADATA_KEY,\n\t);\n}\n\nexport function readPromptDefinitions(\n\tmetadata: DecoratorMetadata,\n): readonly McpPromptDefinition[] {\n\treturn readDefinitions<McpPromptDefinition>(\n\t\tmetadata,\n\t\tMCP_PROMPTS_METADATA_KEY,\n\t);\n}\n","import { appendPromptDefinition } from \"../metadata/metadata.js\";\nimport type { McpPromptOptions } from \"../types.js\";\n\nexport function McpPrompt(options: McpPromptOptions) {\n\treturn function <This>(\n\t\t_value: (this: This) => unknown,\n\t\tcontext: ClassMethodDecoratorContext<This, (this: This) => unknown>,\n\t): void {\n\t\tconst methodName = getMethodName(context);\n\n\t\tappendPromptDefinition(context.metadata, {\n\t\t\tname: options.name ?? methodName,\n\t\t\tmethodName,\n\t\t\tdescription: options.description,\n\t\t});\n\t};\n}\n\nfunction getMethodName(context: { readonly name: string | symbol }): string {\n\tif (typeof context.name !== \"string\") {\n\t\tthrow new TypeError(\"MCP decorators require string-named methods\");\n\t}\n\n\treturn context.name;\n}\n","import { appendResourceDefinition } from \"../metadata/metadata.js\";\nimport type { McpResourceOptions } from \"../types.js\";\n\nexport function McpResource(options: McpResourceOptions) {\n\treturn function (_value: object, context: ClassMethodDecoratorContext): void {\n\t\tconst methodName = getMethodName(context);\n\n\t\tappendResourceDefinition(context.metadata, {\n\t\t\tname: options.name ?? methodName,\n\t\t\tmethodName,\n\t\t\turi: options.uri,\n\t\t\tmimeType: options.mimeType,\n\t\t\tdescription: options.description,\n\t\t});\n\t};\n}\n\nfunction getMethodName(context: ClassMethodDecoratorContext): string {\n\tif (typeof context.name !== \"string\") {\n\t\tthrow new TypeError(\"MCP decorators require string-named methods\");\n\t}\n\n\treturn context.name;\n}\n","import { storeMcpServerDefinition } from \"../metadata/definitions.js\";\nimport {\n\treadPromptDefinitions,\n\treadResourceDefinitions,\n\treadToolDefinitions,\n} from \"../metadata/metadata.js\";\nimport type { McpServerConstructor, McpServerOptions } from \"../types.js\";\n\nexport function McpServer(options: McpServerOptions) {\n\treturn function <T extends McpServerConstructor>(\n\t\ttarget: T,\n\t\tcontext: ClassDecoratorContext,\n\t): void {\n\t\tstoreMcpServerDefinition(target, {\n\t\t\tname: options.name,\n\t\t\tversion: options.version,\n\t\t\ttools: readToolDefinitions(context.metadata),\n\t\t\tresources: readResourceDefinitions(context.metadata),\n\t\t\tprompts: readPromptDefinitions(context.metadata),\n\t\t});\n\t};\n}\n","import { appendToolDefinition } from \"../metadata/metadata.js\";\nimport type { McpToolOptions } from \"../types.js\";\n\nexport function McpTool(options: McpToolOptions) {\n\treturn function (_value: object, context: ClassMethodDecoratorContext): void {\n\t\tconst methodName = getMethodName(context);\n\n\t\tappendToolDefinition(context.metadata, {\n\t\t\tname: options.name ?? methodName,\n\t\t\tmethodName,\n\t\t\tdescription: options.description,\n\t\t\tinput: options.input,\n\t\t});\n\t};\n}\n\nfunction getMethodName(context: ClassMethodDecoratorContext): string {\n\tif (typeof context.name !== \"string\") {\n\t\tthrow new TypeError(\"MCP decorators require string-named methods\");\n\t}\n\n\treturn context.name;\n}\n","import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nexport interface McpServerConnection {\n\tconnect(transport: Transport): Promise<void>;\n}\n\nexport interface StdioServerOptions {\n\treadonly transportFactory?: () => Transport;\n}\n\nexport interface StartedStdioServer<Server extends McpServerConnection> {\n\treadonly server: Server;\n\treadonly transport: Transport;\n}\n\n/**\n * Connects an MCP SDK server to Node's standard input and output streams.\n *\n * The optional transport factory exists for deterministic tests. Production\n * callers should rely on the official SDK StdioServerTransport default.\n */\nexport async function startStdioServer<Server extends McpServerConnection>(\n\tserver: Server,\n\toptions: StdioServerOptions = {},\n): Promise<StartedStdioServer<Server>> {\n\tconst transport = options.transportFactory?.() ?? new StdioServerTransport();\n\tawait server.connect(transport);\n\treturn { server, transport };\n}\n"],"mappings":"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","names":["isRecord","getMethodName","McpServer","getMethodName"]}

package/dist/instance-resolver-BdKelIch.d.cts

@@ -0,0 +1,46 @@
+import { ZodObject } from 'zod';
+
+type McpServerConstructor<T extends object = object, Arguments extends readonly unknown[] = readonly unknown[]> = new (...args: Arguments) => T;
+type ZeroArgumentMcpServerConstructor<T extends object = object> = new () => T;
+interface McpServerOptions {
+    readonly name: string;
+    readonly version: string;
+}
+interface McpToolOptions {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly input: ZodObject;
+}
+interface McpResourceOptions {
+    readonly name?: string | undefined;
+    readonly uri: string;
+    readonly mimeType?: string | undefined;
+    readonly description?: string | undefined;
+}
+interface McpPromptOptions {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+}
+interface McpToolDefinition extends McpToolOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpResourceDefinition extends McpResourceOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpPromptDefinition extends McpPromptOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpServerDefinition extends McpServerOptions {
+    readonly tools: readonly McpToolDefinition[];
+    readonly resources: readonly McpResourceDefinition[];
+    readonly prompts: readonly McpPromptDefinition[];
+}
+
+interface InstanceResolver<T extends object = object> {
+    resolve<Arguments extends readonly unknown[]>(serverClass: McpServerConstructor<T, Arguments>): T | Promise<T>;
+}
+
+export type { InstanceResolver as I, McpServerConstructor as M, ZeroArgumentMcpServerConstructor as Z, McpPromptOptions as a, McpResourceOptions as b, McpServerOptions as c, McpToolOptions as d, McpServerDefinition as e, McpPromptDefinition as f, McpResourceDefinition as g, McpToolDefinition as h };

package/dist/instance-resolver-BdKelIch.d.ts

@@ -0,0 +1,46 @@
+import { ZodObject } from 'zod';
+
+type McpServerConstructor<T extends object = object, Arguments extends readonly unknown[] = readonly unknown[]> = new (...args: Arguments) => T;
+type ZeroArgumentMcpServerConstructor<T extends object = object> = new () => T;
+interface McpServerOptions {
+    readonly name: string;
+    readonly version: string;
+}
+interface McpToolOptions {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+    readonly input: ZodObject;
+}
+interface McpResourceOptions {
+    readonly name?: string | undefined;
+    readonly uri: string;
+    readonly mimeType?: string | undefined;
+    readonly description?: string | undefined;
+}
+interface McpPromptOptions {
+    readonly name?: string | undefined;
+    readonly description?: string | undefined;
+}
+interface McpToolDefinition extends McpToolOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpResourceDefinition extends McpResourceOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpPromptDefinition extends McpPromptOptions {
+    readonly name: string;
+    readonly methodName: string;
+}
+interface McpServerDefinition extends McpServerOptions {
+    readonly tools: readonly McpToolDefinition[];
+    readonly resources: readonly McpResourceDefinition[];
+    readonly prompts: readonly McpPromptDefinition[];
+}
+
+interface InstanceResolver<T extends object = object> {
+    resolve<Arguments extends readonly unknown[]>(serverClass: McpServerConstructor<T, Arguments>): T | Promise<T>;
+}
+
+export type { InstanceResolver as I, McpServerConstructor as M, ZeroArgumentMcpServerConstructor as Z, McpPromptOptions as a, McpResourceOptions as b, McpServerOptions as c, McpToolOptions as d, McpServerDefinition as e, McpPromptDefinition as f, McpResourceDefinition as g, McpToolDefinition as h };

package/dist/langchain.cjs

@@ -0,0 +1,161 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/langchain.ts
+var langchain_exports = {};
+__export(langchain_exports, {
+  createLangChainTools: () => createLangChainTools
+});
+module.exports = __toCommonJS(langchain_exports);
+
+// src/langchain/create-langchain-tools.ts
+var import_tools = require("@langchain/core/tools");
+
+// src/errors.ts
+var TypeMcpDefinitionError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TypeMcpDefinitionError";
+  }
+};
+
+// src/metadata/definitions.ts
+var serverDefinitions = /* @__PURE__ */ new WeakMap();
+function getMcpServerDefinition(target) {
+  const definition = serverDefinitions.get(target);
+  return definition === void 0 ? void 0 : freezeServerDefinition(definition);
+}
+function freezeServerDefinition(definition) {
+  return Object.freeze({
+    name: definition.name,
+    version: definition.version,
+    tools: Object.freeze(
+      definition.tools.map(
+        (tool) => Object.freeze({
+          name: tool.name,
+          methodName: tool.methodName,
+          description: tool.description,
+          input: tool.input
+        })
+      )
+    ),
+    resources: Object.freeze(
+      definition.resources.map(
+        (resource) => Object.freeze({
+          name: resource.name,
+          methodName: resource.methodName,
+          uri: resource.uri,
+          mimeType: resource.mimeType,
+          description: resource.description
+        })
+      )
+    ),
+    prompts: Object.freeze(
+      definition.prompts.map(
+        (prompt) => Object.freeze({
+          name: prompt.name,
+          methodName: prompt.methodName,
+          description: prompt.description
+        })
+      )
+    )
+  });
+}
+
+// src/metadata/read-server-definition.ts
+function readMcpServerDefinition(target) {
+  const definition = getMcpServerDefinition(target);
+  const className = target.name || "<anonymous>";
+  if (definition === void 0) {
+    throw new TypeMcpDefinitionError(
+      `MCP server definition is missing for ${className}`
+    );
+  }
+  assertUniqueNames("tool", definition.tools, className);
+  assertUniqueNames("resource", definition.resources, className);
+  assertUniqueNames("prompt", definition.prompts, className);
+  return definition;
+}
+function assertUniqueNames(componentType, definitions, className) {
+  const names = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
+    if (names.has(definition.name)) {
+      throw new TypeMcpDefinitionError(
+        `Duplicate MCP ${componentType} name "${definition.name}" on ${className}`
+      );
+    }
+    names.add(definition.name);
+  }
+}
+
+// src/resolver/default-instance-resolver.ts
+var defaultInstanceResolver = {
+  resolve(serverClass) {
+    return new serverClass();
+  }
+};
+
+// src/resolver/resolve-server-instance.ts
+async function resolveMcpServerInstance(serverClass, resolver) {
+  if (resolver) {
+    return resolver.resolve(serverClass);
+  }
+  return defaultInstanceResolver.resolve(
+    serverClass
+  );
+}
+
+// src/langchain/create-langchain-tools.ts
+var TOOL_EXECUTION_FAILED = "Tool execution failed";
+async function createLangChainTools(serverClass, options) {
+  const definition = readMcpServerDefinition(serverClass);
+  const instance = options ? await resolveMcpServerInstance(serverClass, options.resolver) : await resolveMcpServerInstance(
+    serverClass
+  );
+  return definition.tools.map((tool) => createLangChainTool(instance, tool));
+}
+function createLangChainTool(instance, definition) {
+  return new import_tools.DynamicStructuredTool({
+    name: definition.name,
+    description: definition.description ?? `${definition.name} tool`,
+    schema: definition.input,
+    func: async (input) => invokeSafely(instance, definition.methodName, input)
+  });
+}
+async function invokeSafely(instance, methodName, input) {
+  try {
+    const method = Reflect.get(instance, methodName);
+    if (typeof method !== "function") {
+      return TOOL_EXECUTION_FAILED;
+    }
+    const result = await Reflect.apply(method, instance, [input]);
+    if (typeof result === "string") {
+      return result;
+    }
+    const serialized = JSON.stringify(result);
+    return serialized === void 0 ? TOOL_EXECUTION_FAILED : serialized;
+  } catch {
+    return TOOL_EXECUTION_FAILED;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLangChainTools
+});
+//# sourceMappingURL=langchain.cjs.map

package/dist/langchain.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/langchain.ts","../src/langchain/create-langchain-tools.ts","../src/errors.ts","../src/metadata/definitions.ts","../src/metadata/read-server-definition.ts","../src/resolver/default-instance-resolver.ts","../src/resolver/resolve-server-instance.ts"],"sourcesContent":["export {\n\ttype CreateLangChainToolsOptions,\n\tcreateLangChainTools,\n} from \"./langchain/create-langchain-tools.js\";\n","import { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { readMcpServerDefinition } from \"../metadata/read-server-definition.js\";\nimport type { InstanceResolver } from \"../resolver/instance-resolver.js\";\nimport { resolveMcpServerInstance } from \"../resolver/resolve-server-instance.js\";\nimport type {\n\tMcpServerConstructor,\n\tMcpToolDefinition,\n\tZeroArgumentMcpServerConstructor,\n} from \"../types.js\";\n\nconst TOOL_EXECUTION_FAILED = \"Tool execution failed\";\n\nexport interface CreateLangChainToolsOptions<T extends object> {\n\treadonly resolver: InstanceResolver<T>;\n}\n\nexport function createLangChainTools<T extends object>(\n\tserverClass: ZeroArgumentMcpServerConstructor<T>,\n): Promise<readonly DynamicStructuredTool[]>;\nexport function createLangChainTools<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\toptions: CreateLangChainToolsOptions<T>,\n): Promise<readonly DynamicStructuredTool[]>;\nexport async function createLangChainTools<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\toptions?: CreateLangChainToolsOptions<T>,\n): Promise<readonly DynamicStructuredTool[]> {\n\tconst definition = readMcpServerDefinition(serverClass);\n\tconst instance = options\n\t\t? await resolveMcpServerInstance(serverClass, options.resolver)\n\t\t: await resolveMcpServerInstance(\n\t\t\t\tserverClass as ZeroArgumentMcpServerConstructor<T>,\n\t\t\t);\n\n\treturn definition.tools.map((tool) => createLangChainTool(instance, tool));\n}\n\nfunction createLangChainTool(\n\tinstance: object,\n\tdefinition: McpToolDefinition,\n): DynamicStructuredTool {\n\treturn new DynamicStructuredTool({\n\t\tname: definition.name,\n\t\tdescription: definition.description ?? `${definition.name} tool`,\n\t\tschema: definition.input,\n\t\tfunc: async (input) => invokeSafely(instance, definition.methodName, input),\n\t});\n}\n\nasync function invokeSafely(\n\tinstance: object,\n\tmethodName: string,\n\tinput: unknown,\n): Promise<string> {\n\ttry {\n\t\tconst method = Reflect.get(instance, methodName);\n\t\tif (typeof method !== \"function\") {\n\t\t\treturn TOOL_EXECUTION_FAILED;\n\t\t}\n\n\t\tconst result = await Reflect.apply(method, instance, [input]);\n\t\tif (typeof result === \"string\") {\n\t\t\treturn result;\n\t\t}\n\n\t\tconst serialized = JSON.stringify(result);\n\t\treturn serialized === undefined ? TOOL_EXECUTION_FAILED : serialized;\n\t} catch {\n\t\treturn TOOL_EXECUTION_FAILED;\n\t}\n}\n","export class TypeMcpDefinitionError extends Error {\n\tpublic constructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"TypeMcpDefinitionError\";\n\t}\n}\n","import type {\n\tMcpPromptDefinition,\n\tMcpResourceDefinition,\n\tMcpServerConstructor,\n\tMcpServerDefinition,\n\tMcpToolDefinition,\n} from \"../types.js\";\n\nexport interface PendingMcpDefinitions {\n\treadonly tools: readonly McpToolDefinition[];\n\treadonly resources: readonly McpResourceDefinition[];\n\treadonly prompts: readonly McpPromptDefinition[];\n}\n\nconst serverDefinitions = new WeakMap<object, McpServerDefinition>();\n\nexport function storeMcpServerDefinition<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\ttarget: McpServerConstructor<T, Arguments>,\n\tdefinition: McpServerDefinition,\n): void {\n\tserverDefinitions.set(target, freezeServerDefinition(definition));\n}\n\nexport function getMcpServerDefinition<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(target: McpServerConstructor<T, Arguments>): McpServerDefinition | undefined {\n\tconst definition = serverDefinitions.get(target);\n\treturn definition === undefined\n\t\t? undefined\n\t\t: freezeServerDefinition(definition);\n}\n\nexport function freezeServerDefinition(\n\tdefinition: McpServerDefinition,\n): McpServerDefinition {\n\treturn Object.freeze({\n\t\tname: definition.name,\n\t\tversion: definition.version,\n\t\ttools: Object.freeze(\n\t\t\tdefinition.tools.map((tool) =>\n\t\t\t\tObject.freeze({\n\t\t\t\t\tname: tool.name,\n\t\t\t\t\tmethodName: tool.methodName,\n\t\t\t\t\tdescription: tool.description,\n\t\t\t\t\tinput: tool.input,\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\tresources: Object.freeze(\n\t\t\tdefinition.resources.map((resource) =>\n\t\t\t\tObject.freeze({\n\t\t\t\t\tname: resource.name,\n\t\t\t\t\tmethodName: resource.methodName,\n\t\t\t\t\turi: resource.uri,\n\t\t\t\t\tmimeType: resource.mimeType,\n\t\t\t\t\tdescription: resource.description,\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t\tprompts: Object.freeze(\n\t\t\tdefinition.prompts.map((prompt) =>\n\t\t\t\tObject.freeze({\n\t\t\t\t\tname: prompt.name,\n\t\t\t\t\tmethodName: prompt.methodName,\n\t\t\t\t\tdescription: prompt.description,\n\t\t\t\t}),\n\t\t\t),\n\t\t),\n\t});\n}\n","import { TypeMcpDefinitionError } from \"../errors.js\";\nimport type {\n\tMcpPromptDefinition,\n\tMcpResourceDefinition,\n\tMcpServerConstructor,\n\tMcpServerDefinition,\n\tMcpToolDefinition,\n} from \"../types.js\";\nimport { getMcpServerDefinition } from \"./definitions.js\";\n\ntype NamedDefinition =\n\t| McpToolDefinition\n\t| McpResourceDefinition\n\t| McpPromptDefinition;\n\nexport function readMcpServerDefinition<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(target: McpServerConstructor<T, Arguments>): McpServerDefinition {\n\tconst definition = getMcpServerDefinition(target);\n\tconst className = target.name || \"<anonymous>\";\n\n\tif (definition === undefined) {\n\t\tthrow new TypeMcpDefinitionError(\n\t\t\t`MCP server definition is missing for ${className}`,\n\t\t);\n\t}\n\n\tassertUniqueNames(\"tool\", definition.tools, className);\n\tassertUniqueNames(\"resource\", definition.resources, className);\n\tassertUniqueNames(\"prompt\", definition.prompts, className);\n\n\treturn definition;\n}\n\nfunction assertUniqueNames(\n\tcomponentType: \"tool\" | \"resource\" | \"prompt\",\n\tdefinitions: readonly NamedDefinition[],\n\tclassName: string,\n): void {\n\tconst names = new Set<string>();\n\n\tfor (const definition of definitions) {\n\t\tif (names.has(definition.name)) {\n\t\t\tthrow new TypeMcpDefinitionError(\n\t\t\t\t`Duplicate MCP ${componentType} name \"${definition.name}\" on ${className}`,\n\t\t\t);\n\t\t}\n\n\t\tnames.add(definition.name);\n\t}\n}\n","import type { ZeroArgumentMcpServerConstructor } from \"../types.js\";\n\nexport const defaultInstanceResolver = {\n\tresolve<T extends object>(\n\t\tserverClass: ZeroArgumentMcpServerConstructor<T>,\n\t): T {\n\t\treturn new serverClass();\n\t},\n};\n","import type {\n\tMcpServerConstructor,\n\tZeroArgumentMcpServerConstructor,\n} from \"../types.js\";\nimport { defaultInstanceResolver } from \"./default-instance-resolver.js\";\nimport type { InstanceResolver } from \"./instance-resolver.js\";\n\nexport function resolveMcpServerInstance<T extends object>(\n\tserverClass: ZeroArgumentMcpServerConstructor<T>,\n): Promise<T>;\nexport function resolveMcpServerInstance<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\tresolver: InstanceResolver<T>,\n): Promise<T>;\nexport async function resolveMcpServerInstance<\n\tT extends object,\n\tArguments extends readonly unknown[],\n>(\n\tserverClass: McpServerConstructor<T, Arguments>,\n\tresolver?: InstanceResolver<T>,\n): Promise<T> {\n\tif (resolver) {\n\t\treturn resolver.resolve(serverClass);\n\t}\n\n\treturn defaultInstanceResolver.resolve(\n\t\tserverClass as ZeroArgumentMcpServerConstructor<T>,\n\t);\n}\n"],"mappings":"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","names":[]}

package/dist/langchain.d.cts

@@ -0,0 +1,11 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { I as InstanceResolver, Z as ZeroArgumentMcpServerConstructor, M as McpServerConstructor } from './instance-resolver-BdKelIch.cjs';
+import 'zod';
+
+interface CreateLangChainToolsOptions<T extends object> {
+    readonly resolver: InstanceResolver<T>;
+}
+declare function createLangChainTools<T extends object>(serverClass: ZeroArgumentMcpServerConstructor<T>): Promise<readonly DynamicStructuredTool[]>;
+declare function createLangChainTools<T extends object, Arguments extends readonly unknown[]>(serverClass: McpServerConstructor<T, Arguments>, options: CreateLangChainToolsOptions<T>): Promise<readonly DynamicStructuredTool[]>;
+
+export { type CreateLangChainToolsOptions, createLangChainTools };

package/dist/langchain.d.ts

@@ -0,0 +1,11 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { I as InstanceResolver, Z as ZeroArgumentMcpServerConstructor, M as McpServerConstructor } from './instance-resolver-BdKelIch.js';
+import 'zod';
+
+interface CreateLangChainToolsOptions<T extends object> {
+    readonly resolver: InstanceResolver<T>;
+}
+declare function createLangChainTools<T extends object>(serverClass: ZeroArgumentMcpServerConstructor<T>): Promise<readonly DynamicStructuredTool[]>;
+declare function createLangChainTools<T extends object, Arguments extends readonly unknown[]>(serverClass: McpServerConstructor<T, Arguments>, options: CreateLangChainToolsOptions<T>): Promise<readonly DynamicStructuredTool[]>;
+
+export { type CreateLangChainToolsOptions, createLangChainTools };