tuttiai-mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { Voice, Permission, Tool, VoiceContext } from '@tuttiai/types';
+
+interface McpVoiceOptions {
+    /** MCP server command, e.g. 'npx @playwright/mcp' */
+    server: string;
+    /** Additional CLI arguments appended after the server command. */
+    args?: string[];
+    /** Extra environment variables passed to the server process. */
+    env?: Record<string, string>;
+    /** Override the voice name (default: mcp-<server-name>). */
+    name?: string;
+}
+declare class McpVoice implements Voice {
+    private options;
+    name: string;
+    description: string;
+    required_permissions: Permission[];
+    tools: Tool[];
+    private client;
+    private transport;
+    private initialized;
+    constructor(options: McpVoiceOptions);
+    setup(_context: VoiceContext): Promise<void>;
+    teardown(): Promise<void>;
+    private discoverTools;
+    private callMcpTool;
+}
+
+export { McpVoice, type McpVoiceOptions };

package/dist/index.js

@@ -0,0 +1,117 @@
+// src/index.ts
+import { z } from "zod";
+import { Client } from "@modelcontextprotocol/sdk/client";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+var McpVoice = class {
+  constructor(options) {
+    this.options = options;
+    const lastSegment = options.server.split(/[\s/]/).filter(Boolean).at(-1) ?? "server";
+    this.name = options.name ?? "mcp-" + lastSegment;
+  }
+  options;
+  name;
+  description = "MCP server bridge";
+  required_permissions = ["network"];
+  tools = [];
+  client;
+  transport;
+  initialized = false;
+  async setup(_context) {
+    if (this.initialized) return;
+    const [command, ...cmdArgs] = this.options.server.split(/\s+/);
+    this.transport = new StdioClientTransport({
+      command,
+      args: [...cmdArgs, ...this.options.args ?? []],
+      env: this.options.env,
+      stderr: "pipe"
+    });
+    this.client = new Client(
+      { name: "tutti", version: "1.0.0" }
+    );
+    await this.client.connect(this.transport);
+    this.tools = await this.discoverTools();
+    this.initialized = true;
+  }
+  async teardown() {
+    if (this.client) {
+      await this.client.close();
+      this.client = void 0;
+    }
+    this.transport = void 0;
+    this.tools = [];
+    this.initialized = false;
+  }
+  async discoverTools() {
+    if (!this.client) throw new Error("MCP client not connected");
+    const { tools: mcpTools } = await this.client.listTools();
+    return mcpTools.map((mcpTool) => {
+      const schema = jsonSchemaToZod(mcpTool.inputSchema);
+      return {
+        name: mcpTool.name,
+        description: mcpTool.description ?? "",
+        parameters: schema,
+        execute: (input, _context) => {
+          return this.callMcpTool(mcpTool.name, input);
+        }
+      };
+    });
+  }
+  async callMcpTool(name, args) {
+    if (!this.client) {
+      return { content: "MCP client not connected", is_error: true };
+    }
+    const result = await this.client.callTool({ name, arguments: args });
+    const text = result.content.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("\n");
+    return {
+      content: text || "(no output)",
+      is_error: result.isError === true
+    };
+  }
+};
+function jsonSchemaToZod(schema) {
+  const properties = schema.properties;
+  const required = schema.required ?? [];
+  if (!properties) {
+    return z.record(z.unknown());
+  }
+  const shape = {};
+  for (const [key, prop] of Object.entries(properties)) {
+    let field = convertType(prop);
+    if (prop.description) {
+      field = field.describe(prop.description);
+    }
+    if (!required.includes(key)) {
+      field = field.optional();
+    }
+    shape[key] = field;
+  }
+  return z.object(shape).passthrough();
+}
+function convertType(prop) {
+  if (prop.enum) {
+    const values = prop.enum;
+    if (values.length > 0) {
+      return z.enum(values);
+    }
+  }
+  switch (prop.type) {
+    case "string":
+      return z.string();
+    case "number":
+      return z.number();
+    case "integer":
+      return z.number().int();
+    case "boolean":
+      return z.boolean();
+    case "array":
+      return z.array(z.unknown());
+    case "object":
+      return z.record(z.unknown());
+    default:
+      return z.unknown();
+  }
+}
+export {
+  McpVoice
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { Client } from \"@modelcontextprotocol/sdk/client\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type {\n  Permission,\n  Tool,\n  ToolContext,\n  ToolResult,\n  Voice,\n  VoiceContext,\n} from \"@tuttiai/types\";\n\nexport interface McpVoiceOptions {\n  /** MCP server command, e.g. 'npx @playwright/mcp' */\n  server: string;\n  /** Additional CLI arguments appended after the server command. */\n  args?: string[];\n  /** Extra environment variables passed to the server process. */\n  env?: Record<string, string>;\n  /** Override the voice name (default: mcp-<server-name>). */\n  name?: string;\n}\n\nexport class McpVoice implements Voice {\n  name: string;\n  description = \"MCP server bridge\";\n  required_permissions: Permission[] = [\"network\"];\n  tools: Tool[] = [];\n\n  private client: Client | undefined;\n  private transport: StdioClientTransport | undefined;\n  private initialized = false;\n\n  constructor(private options: McpVoiceOptions) {\n    const lastSegment = options.server.split(/[\\s/]/).filter(Boolean).at(-1) ?? \"server\";\n    this.name = options.name ?? \"mcp-\" + lastSegment;\n  }\n\n  async setup(_context: VoiceContext): Promise<void> {\n    if (this.initialized) return;\n\n    const [command, ...cmdArgs] = this.options.server.split(/\\s+/);\n\n    this.transport = new StdioClientTransport({\n      command,\n      args: [...cmdArgs, ...(this.options.args ?? [])],\n      env: this.options.env,\n      stderr: \"pipe\",\n    });\n\n    this.client = new Client(\n      { name: \"tutti\", version: \"1.0.0\" },\n    );\n\n    await this.client.connect(this.transport);\n    this.tools = await this.discoverTools();\n    this.initialized = true;\n  }\n\n  async teardown(): Promise<void> {\n    if (this.client) {\n      await this.client.close();\n      this.client = undefined;\n    }\n    this.transport = undefined;\n    this.tools = [];\n    this.initialized = false;\n  }\n\n  private async discoverTools(): Promise<Tool[]> {\n    if (!this.client) throw new Error(\"MCP client not connected\");\n\n    const { tools: mcpTools } = await this.client.listTools();\n\n    return mcpTools.map((mcpTool) => {\n      const schema = jsonSchemaToZod(mcpTool.inputSchema as Record<string, unknown>);\n\n      return {\n        name: mcpTool.name,\n        description: mcpTool.description ?? \"\",\n        parameters: schema,\n        execute: (input: unknown, _context: ToolContext): Promise<ToolResult> => {\n          return this.callMcpTool(mcpTool.name, input as Record<string, unknown>);\n        },\n      };\n    });\n  }\n\n  private async callMcpTool(\n    name: string,\n    args: Record<string, unknown>,\n  ): Promise<ToolResult> {\n    if (!this.client) {\n      return { content: \"MCP client not connected\", is_error: true };\n    }\n\n    const result = await this.client.callTool({ name, arguments: args });\n\n    // MCP result.content is an array of { type: \"text\", text: string } blocks\n    const text = (result.content as { type: string; text?: string }[])\n      .filter((c) => c.type === \"text\" && c.text)\n      .map((c) => c.text)\n      .join(\"\\n\");\n\n    return {\n      content: text || \"(no output)\",\n      is_error: result.isError === true,\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// JSON Schema → Zod converter (covers common MCP tool schemas)\n// ---------------------------------------------------------------------------\n\nfunction jsonSchemaToZod(schema: Record<string, unknown>): z.ZodType {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  const required = (schema.required as string[]) ?? [];\n\n  if (!properties) {\n    return z.record(z.unknown());\n  }\n\n  const shape: Record<string, z.ZodType> = {};\n  for (const [key, prop] of Object.entries(properties)) {\n    let field = convertType(prop);\n    if (prop.description) {\n      field = field.describe(prop.description as string);\n    }\n    if (!required.includes(key)) {\n      field = field.optional() as unknown as z.ZodType;\n    }\n    shape[key] = field;\n  }\n\n  return z.object(shape).passthrough();\n}\n\nfunction convertType(prop: Record<string, unknown>): z.ZodType {\n  if (prop.enum) {\n    const values = prop.enum as string[];\n    if (values.length > 0) {\n      return z.enum(values as [string, ...string[]]);\n    }\n  }\n\n  switch (prop.type) {\n    case \"string\":\n      return z.string();\n    case \"number\":\n      return z.number();\n    case \"integer\":\n      return z.number().int();\n    case \"boolean\":\n      return z.boolean();\n    case \"array\":\n      return z.array(z.unknown());\n    case \"object\":\n      return z.record(z.unknown());\n    default:\n      return z.unknown();\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "tuttiai-mcp",
+  "version": "0.1.0",
+  "description": "MCP bridge voice for Tutti — wrap any MCP server as a Tutti voice",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@tuttiai/types": "*",
+    "zod": "3.25.76"
+  },
+  "keywords": ["tutti", "ai", "agents", "orchestration", "voice", "mcp", "model-context-protocol", "bridge"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tuttiai/tutti",
+    "directory": "voices/mcp"
+  },
+  "homepage": "https://tutti-ai.com"
+}