@titikaka2026/mcptools 0.1.0

package/dist/core/validator.js

@@ -0,0 +1,120 @@
+export class McpValidator {
+    validateMessage(data) {
+        const errors = [];
+        const warnings = [];
+        if (typeof data !== "object" || data === null) {
+            return { valid: false, errors: ["Message must be a JSON object"], warnings };
+        }
+        const msg = data;
+        // Check jsonrpc version
+        if (msg.jsonrpc !== "2.0") {
+            errors.push('Message must have "jsonrpc": "2.0"');
+        }
+        // Must have either method (request/notification) or result/error (response)
+        const isRequest = "method" in msg;
+        const isResponse = "result" in msg || "error" in msg;
+        if (!isRequest && !isResponse) {
+            errors.push("Message must have either 'method' (request) or 'result'/'error' (response)");
+        }
+        if (isRequest) {
+            this.validateRequest(msg, errors, warnings);
+        }
+        if (isResponse) {
+            this.validateResponse(msg, errors, warnings);
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    validateToolDefinition(tool) {
+        const errors = [];
+        const warnings = [];
+        if (typeof tool !== "object" || tool === null) {
+            return { valid: false, errors: ["Tool must be a JSON object"], warnings };
+        }
+        const t = tool;
+        if (typeof t.name !== "string" || t.name.length === 0) {
+            errors.push("Tool must have a non-empty 'name' string");
+        }
+        if (typeof t.description !== "string" || t.description.length === 0) {
+            warnings.push("Tool should have a 'description' for better usability");
+        }
+        if (typeof t.inputSchema !== "object" || t.inputSchema === null) {
+            errors.push("Tool must have an 'inputSchema' object (JSON Schema)");
+        }
+        else {
+            const schema = t.inputSchema;
+            if (schema.type !== "object") {
+                errors.push("Tool inputSchema.type should be 'object'");
+            }
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    validateResourceDefinition(resource) {
+        const errors = [];
+        const warnings = [];
+        if (typeof resource !== "object" || resource === null) {
+            return { valid: false, errors: ["Resource must be a JSON object"], warnings };
+        }
+        const r = resource;
+        if (typeof r.uri !== "string" || r.uri.length === 0) {
+            errors.push("Resource must have a non-empty 'uri' string");
+        }
+        if (typeof r.name !== "string" || r.name.length === 0) {
+            errors.push("Resource must have a non-empty 'name' string");
+        }
+        if (!r.mimeType) {
+            warnings.push("Resource should specify a 'mimeType'");
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    }
+    validateRequest(msg, errors, warnings) {
+        if (typeof msg.method !== "string") {
+            errors.push("Request 'method' must be a string");
+        }
+        // If it has an id, it's a request (not notification) and expects a response
+        if ("id" in msg) {
+            if (typeof msg.id !== "string" && typeof msg.id !== "number") {
+                errors.push("Request 'id' must be a string or number");
+            }
+        }
+        if ("params" in msg && typeof msg.params !== "object") {
+            errors.push("Request 'params' must be an object if present");
+        }
+        // Check for known methods
+        const knownMethods = [
+            "initialize",
+            "tools/list",
+            "tools/call",
+            "resources/list",
+            "resources/read",
+            "prompts/list",
+            "prompts/get",
+            "notifications/initialized",
+            "notifications/cancelled",
+        ];
+        if (typeof msg.method === "string" &&
+            !knownMethods.includes(msg.method) &&
+            !msg.method.startsWith("$/")) {
+            warnings.push(`Unknown method '${msg.method}' — may be a custom extension`);
+        }
+    }
+    validateResponse(msg, errors, _warnings) {
+        if (!("id" in msg)) {
+            errors.push("Response must have an 'id'");
+        }
+        if ("error" in msg) {
+            const error = msg.error;
+            if (typeof error !== "object" || error === null) {
+                errors.push("Response 'error' must be an object");
+            }
+            else {
+                if (typeof error.code !== "number") {
+                    errors.push("Error 'code' must be a number");
+                }
+                if (typeof error.message !== "string") {
+                    errors.push("Error 'message' must be a string");
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"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"}

package/dist/core/wrap-cli.d.ts

@@ -0,0 +1,3 @@
+import type { WrapCliOptions } from "../types.js";
+export declare function wrapCli(options: WrapCliOptions): string;
+//# sourceMappingURL=wrap-cli.d.ts.map

package/dist/core/wrap-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-cli.d.ts","sourceRoot":"","sources":["../../src/core/wrap-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAEjE,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA2GvD"}

package/dist/core/wrap-cli.js

@@ -0,0 +1,144 @@
+export function wrapCli(options) {
+    const { command, name, description, subcommands } = options;
+    const toolDefinitions = subcommands
+        .map((sub) => generateCliToolDefinition(sub))
+        .join(",\n    ");
+    const toolHandlers = subcommands
+        .map((sub) => generateCliToolHandler(sub, command))
+        .join("\n");
+    return `#!/usr/bin/env node
+// Auto-generated MCP server wrapping CLI: ${command}
+// ${description}
+// Generated by mcptools
+
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+const TOOLS = [
+    ${toolDefinitions}
+];
+
+function handleRequest(request) {
+  const { method, id, params } = request;
+
+  switch (method) {
+    case "initialize":
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: "${name}", version: "1.0.0" },
+        },
+      };
+
+    case "tools/list":
+      return { jsonrpc: "2.0", id, result: { tools: TOOLS } };
+
+    case "tools/call":
+      return handleToolCall(id, params?.name, params?.arguments ?? {});
+
+    default:
+      if (id !== undefined) {
+        return {
+          jsonrpc: "2.0",
+          id,
+          error: { code: -32601, message: "Method not found: " + method },
+        };
+      }
+      return null;
+  }
+}
+
+async function handleToolCall(id, toolName, args) {
+  try {
+    const result = await callTool(toolName, args);
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: { content: [{ type: "text", text: result }] },
+    };
+  } catch (error) {
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: {
+        content: [{ type: "text", text: "Error: " + error.message }],
+        isError: true,
+      },
+    };
+  }
+}
+
+async function callTool(name, args) {
+  switch (name) {
+${toolHandlers}
+    default:
+      throw new Error("Unknown tool: " + name);
+  }
+}
+
+let buffer = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", async (chunk) => {
+  buffer += chunk;
+  const lines = buffer.split("\\n");
+  buffer = lines.pop() ?? "";
+
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const request = JSON.parse(line);
+      const response = await handleRequest(request);
+      if (response) {
+        process.stdout.write(JSON.stringify(response) + "\\n");
+      }
+    } catch (e) {
+      // skip malformed input
+    }
+  }
+});
+`;
+}
+function generateCliToolDefinition(sub) {
+    const properties = {};
+    const required = [];
+    for (const arg of sub.args) {
+        properties[arg.name] = {
+            type: arg.type,
+            description: arg.description,
+        };
+        if (arg.required) {
+            required.push(arg.name);
+        }
+    }
+    return JSON.stringify({
+        name: sub.name,
+        description: sub.description,
+        inputSchema: {
+            type: "object",
+            properties,
+            required: required.length > 0 ? required : undefined,
+        },
+    }, null, 6);
+}
+function generateCliToolHandler(sub, command) {
+    const argMapping = sub.args
+        .map((arg) => {
+        if (arg.type === "boolean") {
+            return `      if (args.${arg.name}) cmdArgs.push("--${arg.name}");`;
+        }
+        return `      if (args.${arg.name} !== undefined) cmdArgs.push("--${arg.name}", String(args.${arg.name}));`;
+    })
+        .join("\n");
+    return `    case "${sub.name}": {
+      const cmdArgs = ["${sub.name}"];
+${argMapping}
+      const { stdout, stderr } = await execFileAsync("${command}", cmdArgs);
+      return stdout + (stderr ? "\\nSTDERR:\\n" + stderr : "");
+    }`;
+}
+//# sourceMappingURL=wrap-cli.js.map

package/dist/core/wrap-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-cli.js","sourceRoot":"","sources":["../../src/core/wrap-cli.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE5D,MAAM,eAAe,GAAG,WAAW;SAChC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;SAC5C,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,WAAW;SAC7B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;SAClD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;6CACoC,OAAO;KAC/C,WAAW;;;;;;;;;MASV,eAAe;;;;;;;;;;;;;;iCAcY,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CnC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAkB;IACnD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;YACrB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SACrD;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAkB,EAAE,OAAe;IACjE,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI;SACxB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,kBAAkB,GAAG,CAAC,IAAI,qBAAqB,GAAG,CAAC,IAAI,KAAK,CAAC;QACtE,CAAC;QACD,OAAO,kBAAkB,GAAG,CAAC,IAAI,mCAAmC,GAAG,CAAC,IAAI,kBAAkB,GAAG,CAAC,IAAI,KAAK,CAAC;IAC9G,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,aAAa,GAAG,CAAC,IAAI;0BACJ,GAAG,CAAC,IAAI;EAChC,UAAU;wDAC4C,OAAO;;MAEzD,CAAC;AACP,CAAC"}

package/dist/core/wrap-rest.d.ts

@@ -0,0 +1,4 @@
+import type { WrapRestOptions, RestEndpoint } from "../types.js";
+export declare function wrapRestApi(options: WrapRestOptions): string;
+export declare function generateToolRouter(endpoints: RestEndpoint[]): string;
+//# sourceMappingURL=wrap-rest.d.ts.map

package/dist/core/wrap-rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-rest.d.ts","sourceRoot":"","sources":["../../src/core/wrap-rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAEpF,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAkG5D;AA8DD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAYpE"}

package/dist/core/wrap-rest.js

@@ -0,0 +1,157 @@
+export function wrapRestApi(options) {
+    const { baseUrl, name, endpoints } = options;
+    const toolHandlers = endpoints
+        .map((ep) => generateToolHandler(ep, baseUrl))
+        .join("\n\n");
+    const toolDefinitions = endpoints
+        .map((ep) => generateToolDefinition(ep))
+        .join(",\n    ");
+    return `#!/usr/bin/env node
+// Auto-generated MCP server wrapping REST API: ${name}
+// Generated by mcptools
+
+import { createServer } from "node:http";
+
+const TOOLS = [
+    ${toolDefinitions}
+];
+
+function handleRequest(request) {
+  const { method, id, params } = request;
+
+  switch (method) {
+    case "initialize":
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: "${name}", version: "1.0.0" },
+        },
+      };
+
+    case "tools/list":
+      return { jsonrpc: "2.0", id, result: { tools: TOOLS } };
+
+    case "tools/call":
+      return handleToolCall(id, params?.name, params?.arguments ?? {});
+
+    default:
+      if (id !== undefined) {
+        return {
+          jsonrpc: "2.0",
+          id,
+          error: { code: -32601, message: "Method not found: " + method },
+        };
+      }
+      return null; // notification, no response needed
+  }
+}
+
+${toolHandlers}
+
+async function handleToolCall(id, toolName, args) {
+  try {
+    const result = await callTool(toolName, args);
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] },
+    };
+  } catch (error) {
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: {
+        content: [{ type: "text", text: "Error: " + error.message }],
+        isError: true,
+      },
+    };
+  }
+}
+
+// stdio transport
+let buffer = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", async (chunk) => {
+  buffer += chunk;
+  const lines = buffer.split("\\n");
+  buffer = lines.pop() ?? "";
+
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const request = JSON.parse(line);
+      const response = await handleRequest(request);
+      if (response) {
+        process.stdout.write(JSON.stringify(response) + "\\n");
+      }
+    } catch (e) {
+      // skip malformed input
+    }
+  }
+});
+`;
+}
+function generateToolDefinition(ep) {
+    const properties = {};
+    const required = [];
+    for (const param of ep.parameters ?? []) {
+        properties[param.name] = {
+            type: param.type,
+            description: param.description,
+        };
+        if (param.required) {
+            required.push(param.name);
+        }
+    }
+    return JSON.stringify({
+        name: ep.name,
+        description: ep.description,
+        inputSchema: {
+            type: "object",
+            properties,
+            required: required.length > 0 ? required : undefined,
+        },
+    }, null, 6);
+}
+function generateToolHandler(ep, baseUrl) {
+    const pathParams = (ep.parameters ?? []).filter((p) => p.in === "path");
+    const queryParams = (ep.parameters ?? []).filter((p) => p.in === "query");
+    const bodyParams = (ep.parameters ?? []).filter((p) => p.in === "body");
+    let urlExpr = `"${baseUrl}${ep.path}"`;
+    for (const p of pathParams) {
+        urlExpr = urlExpr.replace(`{${p.name}}`, `\${args.${p.name}}`);
+    }
+    const queryParts = queryParams
+        .map((p) => `args.${p.name} !== undefined ? "${p.name}=" + encodeURIComponent(args.${p.name}) : ""`)
+        .join(", ");
+    const hasQuery = queryParams.length > 0;
+    const hasBody = bodyParams.length > 0 && ep.method !== "GET";
+    return `async function call_${ep.name}(args) {
+  let url = \`${urlExpr.replace(/"/g, "")}\`;
+  ${hasQuery ? `const query = [${queryParts}].filter(Boolean).join("&");
+  if (query) url += "?" + query;` : ""}
+  const response = await fetch(url, {
+    method: "${ep.method}",
+    headers: { "Content-Type": "application/json" },
+    ${hasBody ? `body: JSON.stringify({ ${bodyParams.map((p) => p.name).join(", ")} }),` : ""}
+  });
+  if (!response.ok) throw new Error(\`HTTP \${response.status}: \${await response.text()}\`);
+  return response.json();
+}`;
+}
+export function generateToolRouter(endpoints) {
+    const cases = endpoints
+        .map((ep) => `    case "${ep.name}": return call_${ep.name}(args);`)
+        .join("\n");
+    return `async function callTool(name, args) {
+  switch (name) {
+${cases}
+    default:
+      throw new Error("Unknown tool: " + name);
+  }
+}`;
+}
+//# sourceMappingURL=wrap-rest.js.map

package/dist/core/wrap-rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-rest.js","sourceRoot":"","sources":["../../src/core/wrap-rest.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { McpClient } from "./core/client.js";
+export { McpValidator } from "./core/validator.js";
+export { wrapRestApi } from "./core/wrap-rest.js";
+export { wrapCli } from "./core/wrap-cli.js";
+export type { McpTool, McpResource, McpPrompt, McpServerConfig, McpMessage, McpRequest, McpResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EACV,OAAO,EACP,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { McpClient } from "./core/client.js";
+export { McpValidator } from "./core/validator.js";
+export { wrapRestApi } from "./core/wrap-rest.js";
+export { wrapCli } from "./core/wrap-cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface McpResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpPrompt {
+    name: string;
+    description?: string;
+    arguments?: McpPromptArgument[];
+}
+export interface McpPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface McpServerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport?: "stdio" | "sse";
+    url?: string;
+}
+export interface McpMessage {
+    jsonrpc: "2.0";
+    id?: string | number;
+    method?: string;
+    params?: Record<string, unknown>;
+    result?: unknown;
+    error?: McpError;
+}
+export interface McpRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface McpResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: McpError;
+}
+export interface McpError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface WrapRestOptions {
+    baseUrl: string;
+    name: string;
+    endpoints: RestEndpoint[];
+    outputDir: string;
+}
+export interface RestEndpoint {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    name: string;
+    description: string;
+    parameters?: EndpointParameter[];
+}
+export interface EndpointParameter {
+    name: string;
+    type: "string" | "number" | "boolean";
+    description: string;
+    required?: boolean;
+    in: "query" | "path" | "body";
+}
+export interface WrapCliOptions {
+    command: string;
+    name: string;
+    description: string;
+    subcommands: CliSubcommand[];
+    outputDir: string;
+}
+export interface CliSubcommand {
+    name: string;
+    description: string;
+    args: CliArgument[];
+}
+export interface CliArgument {
+    name: string;
+    description: string;
+    type: "string" | "number" | "boolean";
+    required?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@titikaka2026/mcptools",
+  "version": "0.1.0",
+  "description": "The Swiss Army knife for MCP (Model Context Protocol) — create, test, inspect, and wrap MCP servers with ease.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "claude",
+    "openai",
+    "tool",
+    "cli",
+    "developer-tools"
+  ],
+  "author": "titikaka2024",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/titikaka2024/mcptools.git"
+  },
+  "homepage": "https://github.com/titikaka2024/mcptools",
+  "bugs": {
+    "url": "https://github.com/titikaka2024/mcptools/issues"
+  },
+  "type": "module",
+  "bin": {
+    "mcptools": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "enquirer": "^2.4.1",
+    "ora": "^8.1.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.12",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}