modality-mcp-kit 0.0.1

package/README.md

@@ -0,0 +1,85 @@
+# Modality MCP Kit
+
+Schema conversion utilities for MCP tool development with multi-library support. Provides universal JSON Schema conversion via xsschema and AITool-to-FastMCP transformation utilities.
+
+## Features
+
+- **Universal Schema Conversion**: Convert Zod, Valibot, ArkType, Effect, and Sury schemas to JSON Schema via `xsschema`
+- **MCP Tool Registration**: Transform AITool definitions to FastMCP-compatible format
+- **Type-Safe**: Full TypeScript support with preserved schema types
+- **Lightweight**: Minimal dependencies, focused on MCP tool development
+
+## Installation
+
+```bash
+npm install modality-mcp-kit
+# or
+bun add modality-mcp-kit
+```
+
+## Usage
+
+### Schema Conversion
+
+```typescript
+import { toJsonSchema } from "modality-mcp-kit";
+import { z } from "zod";
+
+const userSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  age: z.number(),
+});
+
+const jsonSchema = toJsonSchema(userSchema);
+```
+
+### MCP Tool Setup
+
+```typescript
+import { setupAITools, ModalityFastMCP } from "modality-mcp-kit";
+import { z } from "zod";
+
+const mcp = new ModalityFastMCP();
+
+const aiTools = {
+  getUserById: {
+    name: "get_user",
+    description: "Get user by ID",
+    inputSchema: z.object({ id: z.string() }),
+    execute: async (args) => {
+      return { id: args.id, name: "John" };
+    },
+  },
+};
+
+// Registers tools with MCP server and transforms inputSchema → parameters
+setupAITools(aiTools, mcp);
+```
+
+## API
+
+### `toJsonSchema(schema)`
+
+Converts any supported schema (Zod, Valibot, ArkType, Effect, Sury) to JSON Schema.
+
+### `setupAITools(aiTools, mcpServer?)`
+
+Transforms AITool definitions to FastMCP format:
+- Converts `inputSchema` to `parameters`
+- Uses key as `name` if not specified
+- Registers with optional MCP server
+
+### `ModalityFastMCP`
+
+FastMCP-compatible implementation with `addTool()` and `getTools()` methods.
+
+## Repository
+
+- **GitHub**: https://github.com/react-atomic/modality
+- **NPM**: https://www.npmjs.com/package/modality-mcp-kit
+
+## License
+
+MIT
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { toJsonSchema } from "xsschema";
+export { setupAITools, ModalityFastMCP } from "./util_mcp_tools_converter";
+export type { AITools, AITool, FastMCPTool, } from "./schemas/schemas_tool_config";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { toJsonSchema } from "xsschema";
+export { setupAITools, ModalityFastMCP } from "./util_mcp_tools_converter";

package/dist/schemas/schemas_tool_config.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Copy of StandardSchemaV1 interface for compatibility
+ */
+import { z } from "zod";
+export interface ToolParameters<Input = unknown, Output = Input> {
+    readonly "~standard": ToolParameters.Props<Input, Output>;
+}
+export declare namespace ToolParameters {
+    interface Props<Input = unknown, Output = Input> {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    interface SuccessResult<Output> {
+        readonly value: Output;
+        readonly issues?: undefined;
+    }
+    interface FailureResult {
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    interface Issue {
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    interface PathSegment {
+        readonly key: PropertyKey;
+    }
+    interface Types<Input = unknown, Output = Input> {
+        readonly input: Input;
+        readonly output: Output;
+    }
+    type InferInput<Schema extends ToolParameters> = NonNullable<Schema["~standard"]["types"]>["input"];
+    type InferOutput<Schema extends ToolParameters> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+/**
+ * Tool interface for AI SDK compatibility
+ */
+export interface AITool<T extends Record<string, unknown> | undefined = any, TParams extends ToolParameters = z.ZodSchema> {
+    annotations?: {
+        streamingHint?: boolean;
+    } & {
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+        readOnlyHint?: boolean;
+        title?: string;
+    };
+    canAccess?: (auth: T) => boolean;
+    description?: string;
+    execute: (args: ToolParameters.InferOutput<TParams>, context?: any) => Promise<any>;
+    name?: string;
+    inputSchema?: TParams;
+    timeoutMs?: number;
+}
+export interface FastMCPTool<T extends Record<string, unknown> | undefined = any, TParams extends ToolParameters = ToolParameters> extends AITool<T, TParams> {
+    parameters?: TParams;
+    name: string;
+}
+/**
+ * Type for a collection of AI tools with preserved schema types
+ * @template T - Record mapping tool names to their inputSchema types
+ * @example AITools<{getUserById: z.object({id: z.string()}), createUser: z.object({name: z.string()})}>
+ */
+export type AITools<T extends Record<string, ToolParameters> = Record<string, z.ZodSchema>> = {
+    [K in keyof T]: AITool<any, T[K]>;
+};

package/dist/schemas/schemas_tool_config.js

@@ -0,0 +1 @@
+export {};

package/dist/util_mcp_tools_converter.d.ts

@@ -0,0 +1,28 @@
+import type { AITools, FastMCPTool, ToolParameters } from "./schemas/schemas_tool_config";
+/**
+ * FastMCP-compatible interface for MCP server functionality
+ * Provides exact API compatibility with FastMCP.addTool method
+ */
+export interface FastMCPCompatible {
+    addTool<Params extends ToolParameters>(tool: FastMCPTool<any, Params>): void;
+}
+/**
+ * ModalityFastMCP - A FastMCP-compatible implementation
+ * Provides addTool and getTools functionality for managing MCP tools
+ */
+export declare class ModalityFastMCP implements FastMCPCompatible {
+    private tools;
+    /**
+     * Add a tool to the server
+     */
+    addTool<Params extends ToolParameters>(tool: FastMCPTool<any, Params>): void;
+    /**
+     * Get all registered tools
+     */
+    getTools(): FastMCPTool<any, any>[];
+}
+/**
+ * Setup function that optionally registers AITools with MCP server
+ * Automatically infers and preserves schema types from the input
+ */
+export declare const setupAITools: <T extends Record<string, ToolParameters>>(aiTools: AITools<T>, mcpServer?: FastMCPCompatible) => AITools<T>;

package/dist/util_mcp_tools_converter.js

@@ -0,0 +1,38 @@
+/**
+ * ModalityFastMCP - A FastMCP-compatible implementation
+ * Provides addTool and getTools functionality for managing MCP tools
+ */
+export class ModalityFastMCP {
+    tools = new Map();
+    /**
+     * Add a tool to the server
+     */
+    addTool(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Get all registered tools
+     */
+    getTools() {
+        return Array.from(this.tools.values());
+    }
+}
+/**
+ * Setup function that optionally registers AITools with MCP server
+ * Automatically infers and preserves schema types from the input
+ */
+export const setupAITools = (aiTools, mcpServer) => {
+    // Only register tools with MCP server if provided
+    if (mcpServer) {
+        Object.entries(aiTools).forEach(([toolName, aiTool]) => {
+            let name = null != aiTool.name ? aiTool.name : toolName;
+            const { inputSchema, ...restAITool } = aiTool; // Destructure to avoid unused variable warning
+            mcpServer.addTool({
+                ...restAITool,
+                parameters: inputSchema,
+                name,
+            });
+        });
+    }
+    return aiTools;
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "version": "0.0.1",
+  "name": "modality-mcp-kit",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/react-atomic/modality"
+  },
+  "homepage": "https://github.com/react-atomic/modality/tree/main/modality-mcp-kit",
+  "description": "Modality MCP Kit - Schema conversion utilities for MCP tool development with multi-library support",
+  "keywords": [
+    "mcp",
+    "mcp-toolkit",
+    "mcp-tools",
+    "model-context-protocol",
+    "json-schema",
+    "xsschema",
+    "schema-conversion",
+    "tool-parameters",
+    "zod",
+    "typescript"
+  ],
+  "author": "Hill <hill@kimo.com>",
+  "license": "ISC",
+  "dependencies": {
+    "xsschema": "0.3.5",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.22",
+    "typescript": "^5.9.2"
+  },
+  "exports": {
+    "types": "./dist/types/index.d.ts",
+    "require": "./dist/index.js",
+    "import": "./dist/index.js"
+  },
+  "types": "./dist/types/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "scripts": {
+    "build": "bun tsc -p ./",
+    "build:types": "echo 'Starting build validation...' && bun --version && echo 'Running TypeScript type checking...' && bun tsc --noEmit --strict && echo '✅ Build validation successful - no TypeScript errors found' || (echo '❌ Build failed' && exit 1)",
+    "test": "bun test",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "files": ["package.json", "README.md", "dist"]
+}