toolcall 0.0.3 → 0.1.0

package/README.md

@@ -0,0 +1,419 @@
+# toolcall
+
+Create MCP (Model Context Protocol) servers with zero boilerplate.
+
+[![npm version](https://badge.fury.io/js/toolcall.svg)](https://www.npmjs.com/package/toolcall)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Minimal API** - Just two functions: `serve()` and `tool()`
+- **Type-safe** - Full TypeScript support with Zod schema validation
+- **Multiple transports** - Supports both stdio and HTTP
+- **MCP compliant** - Implements MCP protocol version `2024-11-05`
+- **Client included** - Connect to any MCP server programmatically
+
+## Installation
+
+```bash
+npm install toolcall zod
+```
+
+## Quick Start
+
+Create an MCP server in just a few lines:
+
+```typescript
+import { serve, tool } from 'toolcall'
+import { z } from 'zod'
+
+serve({
+  name: 'my-server',
+  version: '1.0.0',
+  tools: {
+    greet: tool({
+      description: 'Greet someone by name',
+      parameters: z.object({
+        name: z.string().describe('The name of the person to greet')
+      }),
+      execute: ({ name }) => `Hello, ${name}!`
+    }),
+
+    add: tool({
+      description: 'Add two numbers',
+      parameters: z.object({
+        a: z.number().describe('First number'),
+        b: z.number().describe('Second number')
+      }),
+      execute: ({ a, b }) => ({ result: a + b })
+    })
+  }
+})
+```
+
+Run it:
+
+```bash
+npx tsx server.ts
+```
+
+## Claude Code Integration
+
+toolcall servers integrate seamlessly with [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Add your server to Claude Code's MCP configuration:
+
+### 1. Create your server file
+
+```typescript
+// my-tools.ts
+import { serve, tool } from 'toolcall'
+import { z } from 'zod'
+
+serve({
+  name: 'my-tools',
+  tools: {
+    get_weather: tool({
+      description: 'Get current weather for a city',
+      parameters: z.object({
+        city: z.string().describe('City name'),
+        unit: z.enum(['celsius', 'fahrenheit']).default('celsius')
+      }),
+      execute: async ({ city, unit }) => {
+        // Your implementation here
+        return { city, temperature: 22, unit, condition: 'sunny' }
+      }
+    })
+  }
+})
+```
+
+### 2. Configure Claude Code
+
+Add to your Claude Code MCP settings (`~/.claude/claude_desktop_config.json` or via Claude Code settings):
+
+```json
+{
+  "mcpServers": {
+    "my-tools": {
+      "command": "npx",
+      "args": ["tsx", "/path/to/my-tools.ts"]
+    }
+  }
+}
+```
+
+Or if you've compiled your TypeScript:
+
+```json
+{
+  "mcpServers": {
+    "my-tools": {
+      "command": "node",
+      "args": ["/path/to/my-tools.js"]
+    }
+  }
+}
+```
+
+### 3. Use in Claude Code
+
+Once configured, Claude Code will automatically discover your tools. You can ask Claude to use them:
+
+> "Use my get_weather tool to check the weather in Tokyo"
+
+## API Reference
+
+### `serve(options)`
+
+Creates and starts an MCP server.
+
+```typescript
+serve({
+  name: 'my-server',        // Server name (default: 'toolcall-server')
+  version: '1.0.0',         // Server version (default: '1.0.0')
+  transport: 'stdio',       // Transport type: 'stdio' | 'http' (default: 'stdio')
+  port: 3000,               // Port for HTTP transport (default: 3000)
+  tools: {                  // Tool definitions
+    // ... your tools
+  }
+})
+```
+
+### `tool(definition)`
+
+Defines a type-safe tool with Zod schema validation.
+
+```typescript
+tool({
+  description: 'Tool description shown to clients',
+  parameters: z.object({
+    // Zod schema for parameters
+  }),
+  execute: async (params) => {
+    // Tool implementation
+    // Can return string, object, or any JSON-serializable value
+  }
+})
+```
+
+### Parameter Types
+
+toolcall supports all Zod types:
+
+```typescript
+import { z } from 'zod'
+
+// Strings
+z.string()
+z.string().min(1).max(100)
+z.string().email()
+z.string().url()
+
+// Numbers
+z.number()
+z.number().min(0).max(100)
+z.number().int()
+
+// Booleans
+z.boolean()
+
+// Enums
+z.enum(['option1', 'option2', 'option3'])
+
+// Arrays
+z.array(z.string())
+
+// Optional with defaults
+z.string().optional()
+z.number().default(10)
+
+// Descriptions (shown in tool schema)
+z.string().describe('Parameter description')
+```
+
+### Return Values
+
+Tools can return any JSON-serializable value:
+
+```typescript
+// String return
+execute: ({ name }) => `Hello, ${name}!`
+
+// Object return (automatically JSON-stringified)
+execute: ({ a, b }) => ({ result: a + b, operation: 'addition' })
+
+// Async operations
+execute: async ({ url }) => {
+  const response = await fetch(url)
+  return await response.json()
+}
+```
+
+## Transports
+
+### Stdio (Default)
+
+The stdio transport reads JSON-RPC messages from stdin and writes responses to stdout. This is the standard transport for MCP servers used by Claude Code and other MCP clients.
+
+```typescript
+serve({
+  transport: 'stdio',  // or omit - stdio is default
+  tools: { /* ... */ }
+})
+```
+
+### HTTP
+
+The HTTP transport creates an HTTP server that accepts JSON-RPC POST requests.
+
+```typescript
+serve({
+  transport: 'http',
+  port: 3000,
+  tools: { /* ... */ }
+})
+```
+
+Test with curl:
+
+```bash
+# Initialize
+curl -X POST http://localhost:3000 \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}}}'
+
+# List tools
+curl -X POST http://localhost:3000 \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
+
+# Call a tool
+curl -X POST http://localhost:3000 \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"greet","arguments":{"name":"World"}}}'
+```
+
+## Client Usage
+
+toolcall includes a client for connecting to any MCP server:
+
+```typescript
+import { connect } from 'toolcall'
+
+// Connect to a stdio server
+const client = await connect('npx tsx ./server.ts')
+
+// Or connect to an HTTP server
+const client = await connect('http://localhost:3000')
+
+// List available tools
+console.log(client.listTools())
+
+// Call a tool
+const result = await client.call('greet', { name: 'World' })
+console.log(result)  // "Hello, World!"
+
+// Clean up
+client.close()
+```
+
+## Complete Example
+
+```typescript
+import { serve, tool } from 'toolcall'
+import { z } from 'zod'
+
+serve({
+  name: 'example-server',
+  version: '1.0.0',
+  tools: {
+    // Simple string return
+    greet: tool({
+      description: 'Greet someone by name',
+      parameters: z.object({
+        name: z.string().describe('The name of the person to greet')
+      }),
+      execute: ({ name }) => `Hello, ${name}!`
+    }),
+
+    // Object return
+    add: tool({
+      description: 'Add two numbers together',
+      parameters: z.object({
+        a: z.number().describe('First number'),
+        b: z.number().describe('Second number')
+      }),
+      execute: ({ a, b }) => ({ result: a + b })
+    }),
+
+    // Async with enum and default
+    get_weather: tool({
+      description: 'Get the current weather for a city',
+      parameters: z.object({
+        city: z.string().describe('City name'),
+        unit: z.enum(['celsius', 'fahrenheit']).default('celsius').describe('Temperature unit')
+      }),
+      execute: async ({ city, unit }) => {
+        // Simulate API call
+        const temp = Math.round(Math.random() * 30 + 10)
+        const tempInUnit = unit === 'fahrenheit' ? Math.round(temp * 9 / 5 + 32) : temp
+        return {
+          city,
+          temperature: tempInUnit,
+          unit,
+          condition: ['sunny', 'cloudy', 'rainy'][Math.floor(Math.random() * 3)]
+        }
+      }
+    }),
+
+    // Constrained parameters
+    search: tool({
+      description: 'Search for information',
+      parameters: z.object({
+        query: z.string().describe('Search query'),
+        limit: z.number().min(1).max(100).default(10).describe('Maximum results')
+      }),
+      execute: async ({ query, limit }) => {
+        return {
+          query,
+          results: Array.from({ length: Math.min(limit, 3) }, (_, i) => ({
+            title: `Result ${i + 1} for "${query}"`,
+            url: `https://example.com/result/${i + 1}`
+          }))
+        }
+      }
+    })
+  }
+})
+```
+
+## Error Handling
+
+toolcall automatically validates parameters against your Zod schemas. Invalid parameters return a JSON-RPC error:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "error": {
+    "code": -32602,
+    "message": "Invalid parameters",
+    "data": {
+      "name": { "_errors": ["Required"] }
+    }
+  }
+}
+```
+
+Errors thrown in tool execution are caught and returned as internal errors:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "error": {
+    "code": -32603,
+    "message": "Internal error",
+    "data": "Error message here"
+  }
+}
+```
+
+## Protocol Details
+
+toolcall implements the [Model Context Protocol](https://modelcontextprotocol.io/) specification:
+
+- **Protocol Version**: `2024-11-05`
+- **Transport**: JSON-RPC 2.0 over stdio or HTTP
+- **Methods**:
+  - `initialize` - Server initialization handshake
+  - `notifications/initialized` - Client initialization acknowledgment
+  - `tools/list` - List available tools
+  - `tools/call` - Execute a tool
+  - `ping` - Health check
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run example server
+npx tsx examples/server.ts
+
+# Run tests
+npm test
+```
+
+## License
+
+MIT
+
+## Author
+
+Yi Min Yang (https://www.yiminyang.dev)

package/dist/client.d.ts

@@ -0,0 +1,52 @@
+import type { McpToolDefinition } from './types.js';
+/**
+ * MCP Client for connecting to MCP servers
+ */
+export declare class McpClient {
+    private process;
+    private httpUrl;
+    private requestId;
+    private pendingRequests;
+    private tools;
+    private constructor();
+    /**
+     * Connect to an MCP server
+     *
+     * @param target - Either a command to spawn (e.g., 'node server.js')
+     *                 or an HTTP URL (e.g., 'http://localhost:3000')
+     *
+     * @example
+     * ```ts
+     * // Connect to stdio server
+     * const client = await connect('node ./my-server.js')
+     *
+     * // Connect to HTTP server
+     * const client = await connect('http://localhost:3000')
+     *
+     * // Call a tool
+     * const result = await client.call('greet', { name: 'World' })
+     * ```
+     */
+    static connect(target: string): Promise<McpClient>;
+    /**
+     * Send a JSON-RPC request
+     */
+    private request;
+    /**
+     * Call a tool by name
+     */
+    call(toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List available tools
+     */
+    listTools(): McpToolDefinition[];
+    /**
+     * Close the connection
+     */
+    close(): void;
+}
+/**
+ * Connect to an MCP server
+ */
+export declare const connect: typeof McpClient.connect;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmC,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAOpF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,KAAK,CAA0B;IAEvC,OAAO;IAEP;;;;;;;;;;;;;;;;;OAiBG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAwDxD;;OAEG;YACW,OAAO;IA4BrB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBlF;;OAEG;IACH,SAAS,IAAI,iBAAiB,EAAE;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,0BAAoB,CAAA"}

package/dist/client.js

@@ -0,0 +1,149 @@
+import { spawn } from 'node:child_process';
+import * as readline from 'node:readline';
+/**
+ * MCP Client for connecting to MCP servers
+ */
+export class McpClient {
+    process = null;
+    httpUrl = null;
+    requestId = 0;
+    pendingRequests = new Map();
+    tools = [];
+    constructor() { }
+    /**
+     * Connect to an MCP server
+     *
+     * @param target - Either a command to spawn (e.g., 'node server.js')
+     *                 or an HTTP URL (e.g., 'http://localhost:3000')
+     *
+     * @example
+     * ```ts
+     * // Connect to stdio server
+     * const client = await connect('node ./my-server.js')
+     *
+     * // Connect to HTTP server
+     * const client = await connect('http://localhost:3000')
+     *
+     * // Call a tool
+     * const result = await client.call('greet', { name: 'World' })
+     * ```
+     */
+    static async connect(target) {
+        const client = new McpClient();
+        if (target.startsWith('http://') || target.startsWith('https://')) {
+            client.httpUrl = target;
+        }
+        else {
+            // Spawn stdio process
+            const [command, ...args] = target.split(' ');
+            client.process = spawn(command, args, {
+                stdio: ['pipe', 'pipe', 'inherit']
+            });
+            // Set up response handling
+            const rl = readline.createInterface({
+                input: client.process.stdout,
+                terminal: false
+            });
+            rl.on('line', (line) => {
+                if (!line.trim())
+                    return;
+                try {
+                    const response = JSON.parse(line);
+                    const pending = client.pendingRequests.get(response.id);
+                    if (pending) {
+                        client.pendingRequests.delete(response.id);
+                        pending.resolve(response);
+                    }
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            });
+            client.process.on('exit', () => {
+                for (const pending of client.pendingRequests.values()) {
+                    pending.reject(new Error('Process exited'));
+                }
+                client.pendingRequests.clear();
+            });
+        }
+        // Initialize connection
+        await client.request('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'toolcall-client', version: '1.0.0' }
+        });
+        await client.request('notifications/initialized', {});
+        // Get available tools
+        const toolsResponse = await client.request('tools/list', {});
+        client.tools = toolsResponse.result.tools;
+        return client;
+    }
+    /**
+     * Send a JSON-RPC request
+     */
+    async request(method, params) {
+        const id = ++this.requestId;
+        const request = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            params
+        };
+        if (this.httpUrl) {
+            const response = await fetch(this.httpUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(request)
+            });
+            return response.json();
+        }
+        if (!this.process?.stdin) {
+            throw new Error('Not connected');
+        }
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            this.process.stdin.write(JSON.stringify(request) + '\n');
+        });
+    }
+    /**
+     * Call a tool by name
+     */
+    async call(toolName, args = {}) {
+        const response = await this.request('tools/call', {
+            name: toolName,
+            arguments: args
+        });
+        if (response.error) {
+            throw new Error(response.error.message);
+        }
+        const result = response.result;
+        const text = result.content[0]?.text ?? '';
+        // Try to parse as JSON
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    /**
+     * List available tools
+     */
+    listTools() {
+        return this.tools;
+    }
+    /**
+     * Close the connection
+     */
+    close() {
+        if (this.process) {
+            this.process.kill();
+            this.process = null;
+        }
+    }
+}
+/**
+ * Connect to an MCP server
+ */
+export const connect = McpClient.connect;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * toolcall - FastMCP for JavaScript
+ *
+ * Create MCP servers with zero boilerplate.
+ *
+ * @example
+ * ```ts
+ * import { serve, tool } from 'toolcall'
+ * import { z } from 'zod'
+ *
+ * serve({
+ *   tools: {
+ *     greet: tool({
+ *       description: 'Greet someone',
+ *       parameters: z.object({
+ *         name: z.string().describe('Name to greet')
+ *       }),
+ *       execute: ({ name }) => `Hello, ${name}!`
+ *     }),
+ *
+ *     add: tool({
+ *       description: 'Add two numbers',
+ *       parameters: z.object({
+ *         a: z.number(),
+ *         b: z.number()
+ *       }),
+ *       execute: ({ a, b }) => a + b
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export { serve } from './server.js';
+export { tool } from './tool.js';
+export { connect, McpClient } from './client.js';
+export { zodToMcpSchema, toolToMcpDefinition } from './schema.js';
+export type { ToolDefinition, ToolRegistry, ServeOptions, McpToolDefinition, McpCapabilities, McpServerInfo, JsonRpcRequest, JsonRpcResponse } 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * toolcall - FastMCP for JavaScript
+ *
+ * Create MCP servers with zero boilerplate.
+ *
+ * @example
+ * ```ts
+ * import { serve, tool } from 'toolcall'
+ * import { z } from 'zod'
+ *
+ * serve({
+ *   tools: {
+ *     greet: tool({
+ *       description: 'Greet someone',
+ *       parameters: z.object({
+ *         name: z.string().describe('Name to greet')
+ *       }),
+ *       execute: ({ name }) => `Hello, ${name}!`
+ *     }),
+ *
+ *     add: tool({
+ *       description: 'Add two numbers',
+ *       parameters: z.object({
+ *         a: z.number(),
+ *         b: z.number()
+ *       }),
+ *       execute: ({ a, b }) => a + b
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export { serve } from './server.js';
+export { tool } from './tool.js';
+export { connect, McpClient } from './client.js';
+export { zodToMcpSchema, toolToMcpDefinition } from './schema.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { McpToolDefinition, ToolDefinition } from './types.js';
+/**
+ * Convert a Zod schema to MCP-compatible JSON Schema
+ */
+export declare function zodToMcpSchema(schema: z.ZodType): McpToolDefinition['inputSchema'];
+/**
+ * Convert a tool definition to MCP tool format
+ */
+export declare function toolToMcpDefinition(name: string, tool: ToolDefinition): McpToolDefinition;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AASnE;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAmBlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,iBAAiB,CAMnB"}

package/dist/schema.js

@@ -0,0 +1,33 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Convert a Zod schema to MCP-compatible JSON Schema
+ */
+export function zodToMcpSchema(schema) {
+    const jsonSchema = zodToJsonSchema(schema, { target: 'openApi3' });
+    // Ensure we have an object schema
+    if (typeof jsonSchema !== 'object' || jsonSchema.type !== 'object') {
+        return {
+            type: 'object',
+            properties: {
+                value: jsonSchema
+            },
+            required: ['value']
+        };
+    }
+    return {
+        type: 'object',
+        properties: (jsonSchema.properties ?? {}),
+        required: jsonSchema.required
+    };
+}
+/**
+ * Convert a tool definition to MCP tool format
+ */
+export function toolToMcpDefinition(name, tool) {
+    return {
+        name,
+        description: tool.description,
+        inputSchema: zodToMcpSchema(tool.parameters)
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAUpD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAqB,CAAA;IAEtF,kCAAkC;IAClC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,UAAqC;aAC7C;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAA4B;QACpE,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,IAAoB;IAEpB,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;KAC7C,CAAA;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+import type { ServeOptions, ToolRegistry } from './types.js';
+/**
+ * Create and start an MCP server with the given tools
+ *
+ * @example
+ * ```ts
+ * import { serve, tool } from 'toolcall'
+ * import { z } from 'zod'
+ *
+ * serve({
+ *   name: 'my-server',
+ *   tools: {
+ *     greet: tool({
+ *       description: 'Greet someone',
+ *       parameters: z.object({ name: z.string() }),
+ *       execute: ({ name }) => `Hello, ${name}!`
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export declare function serve(config: ServeOptions & {
+    tools: ToolRegistry;
+}): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAMnB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,GAC7C,IAAI,CAgIN"}

package/dist/server.js

@@ -0,0 +1,131 @@
+import { toolToMcpDefinition } from './schema.js';
+import { createStdioTransport, createHttpTransport } from './transport.js';
+const PROTOCOL_VERSION = '2024-11-05';
+/**
+ * Create and start an MCP server with the given tools
+ *
+ * @example
+ * ```ts
+ * import { serve, tool } from 'toolcall'
+ * import { z } from 'zod'
+ *
+ * serve({
+ *   name: 'my-server',
+ *   tools: {
+ *     greet: tool({
+ *       description: 'Greet someone',
+ *       parameters: z.object({ name: z.string() }),
+ *       execute: ({ name }) => `Hello, ${name}!`
+ *     })
+ *   }
+ * })
+ * ```
+ */
+export function serve(config) {
+    const { name = 'toolcall-server', version = '1.0.0', transport = 'stdio', port = 3000, tools } = config;
+    const serverInfo = { name, version };
+    const capabilities = { tools: {} };
+    async function handleRequest(request) {
+        const { id, method, params } = request;
+        try {
+            switch (method) {
+                case 'initialize': {
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            protocolVersion: PROTOCOL_VERSION,
+                            capabilities,
+                            serverInfo
+                        }
+                    };
+                }
+                case 'notifications/initialized': {
+                    // Client acknowledged initialization - no response needed for notifications
+                    // but we return success anyway since some clients expect it
+                    return { jsonrpc: '2.0', id, result: {} };
+                }
+                case 'tools/list': {
+                    const toolList = Object.entries(tools).map(([toolName, toolDef]) => toolToMcpDefinition(toolName, toolDef));
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: { tools: toolList }
+                    };
+                }
+                case 'tools/call': {
+                    const { name: toolName, arguments: args } = params;
+                    const toolDef = tools[toolName];
+                    if (!toolDef) {
+                        return {
+                            jsonrpc: '2.0',
+                            id,
+                            error: {
+                                code: -32602,
+                                message: `Unknown tool: ${toolName}`
+                            }
+                        };
+                    }
+                    // Validate parameters
+                    const parseResult = toolDef.parameters.safeParse(args ?? {});
+                    if (!parseResult.success) {
+                        return {
+                            jsonrpc: '2.0',
+                            id,
+                            error: {
+                                code: -32602,
+                                message: 'Invalid parameters',
+                                data: parseResult.error.format()
+                            }
+                        };
+                    }
+                    // Execute the tool
+                    const result = await toolDef.execute(parseResult.data);
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+                                }
+                            ]
+                        }
+                    };
+                }
+                case 'ping': {
+                    return { jsonrpc: '2.0', id, result: {} };
+                }
+                default: {
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        error: {
+                            code: -32601,
+                            message: `Method not found: ${method}`
+                        }
+                    };
+                }
+            }
+        }
+        catch (error) {
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: 'Internal error',
+                    data: error instanceof Error ? error.message : String(error)
+                }
+            };
+        }
+    }
+    if (transport === 'http') {
+        createHttpTransport(handleRequest, port);
+    }
+    else {
+        createStdioTransport(handleRequest);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ToolDefinition } from './types.js';
+/**
+ * Define a tool with type-safe parameters
+ *
+ * @example
+ * ```ts
+ * const getWeather = tool({
+ *   description: 'Get weather for a city',
+ *   parameters: z.object({
+ *     city: z.string().describe('City name'),
+ *     unit: z.enum(['celsius', 'fahrenheit']).default('celsius')
+ *   }),
+ *   execute: async ({ city, unit }) => {
+ *     // Implementation
+ *     return { temperature: 22, unit }
+ *   }
+ * })
+ * ```
+ */
+export declare function tool<T extends z.ZodType>(definition: ToolDefinition<T>): ToolDefinition<T>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACtC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAC5B,cAAc,CAAC,CAAC,CAAC,CAEnB"}

package/dist/tool.js

@@ -0,0 +1,22 @@
+/**
+ * Define a tool with type-safe parameters
+ *
+ * @example
+ * ```ts
+ * const getWeather = tool({
+ *   description: 'Get weather for a city',
+ *   parameters: z.object({
+ *     city: z.string().describe('City name'),
+ *     unit: z.enum(['celsius', 'fahrenheit']).default('celsius')
+ *   }),
+ *   execute: async ({ city, unit }) => {
+ *     // Implementation
+ *     return { temperature: 22, unit }
+ *   }
+ * })
+ * ```
+ */
+export function tool(definition) {
+    return definition;
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAClB,UAA6B;IAE7B,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,12 @@
+import * as http from 'node:http';
+import type { JsonRpcRequest, JsonRpcResponse } from './types.js';
+export type MessageHandler = (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
+/**
+ * Create a stdio transport for MCP communication
+ */
+export declare function createStdioTransport(handler: MessageHandler): void;
+/**
+ * Create an HTTP transport for MCP communication
+ */
+export declare function createHttpTransport(handler: MessageHandler, port: number): http.Server;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAElF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA+BlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAmDtF"}

package/dist/transport.js

@@ -0,0 +1,87 @@
+import * as readline from 'node:readline';
+import * as http from 'node:http';
+/**
+ * Create a stdio transport for MCP communication
+ */
+export function createStdioTransport(handler) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: false
+    });
+    rl.on('line', async (line) => {
+        if (!line.trim())
+            return;
+        try {
+            const request = JSON.parse(line);
+            const response = await handler(request);
+            console.log(JSON.stringify(response));
+        }
+        catch (error) {
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id: 0,
+                error: {
+                    code: -32700,
+                    message: 'Parse error',
+                    data: error instanceof Error ? error.message : String(error)
+                }
+            };
+            console.log(JSON.stringify(errorResponse));
+        }
+    });
+    rl.on('close', () => {
+        process.exit(0);
+    });
+}
+/**
+ * Create an HTTP transport for MCP communication
+ */
+export function createHttpTransport(handler, port) {
+    const server = http.createServer(async (req, res) => {
+        // CORS headers
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        if (req.method !== 'POST') {
+            res.writeHead(405);
+            res.end('Method not allowed');
+            return;
+        }
+        let body = '';
+        for await (const chunk of req) {
+            body += chunk;
+        }
+        try {
+            const request = JSON.parse(body);
+            const response = await handler(request);
+            res.setHeader('Content-Type', 'application/json');
+            res.writeHead(200);
+            res.end(JSON.stringify(response));
+        }
+        catch (error) {
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id: 0,
+                error: {
+                    code: -32700,
+                    message: 'Parse error',
+                    data: error instanceof Error ? error.message : String(error)
+                }
+            };
+            res.setHeader('Content-Type', 'application/json');
+            res.writeHead(200);
+            res.end(JSON.stringify(errorResponse));
+        }
+    });
+    server.listen(port, () => {
+        console.error(`[toolcall] MCP server listening on http://localhost:${port}`);
+    });
+    return server;
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type { z } from 'zod';
+/** JSON-RPC request structure */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: unknown;
+}
+/** JSON-RPC response structure */
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** MCP Tool definition as returned by list_tools */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/** MCP Server capabilities */
+export interface McpCapabilities {
+    tools?: Record<string, never>;
+    resources?: Record<string, never>;
+    prompts?: Record<string, never>;
+}
+/** MCP Server info */
+export interface McpServerInfo {
+    name: string;
+    version: string;
+}
+/** Tool definition with Zod schema */
+export interface ToolDefinition<T extends z.ZodType = z.ZodType> {
+    description: string;
+    parameters: T;
+    execute: (params: z.infer<T>) => Promise<unknown> | unknown;
+}
+/** Options for serve() */
+export interface ServeOptions {
+    /** Server name (shown to clients) */
+    name?: string;
+    /** Server version */
+    version?: string;
+    /** Transport type: 'stdio' (default) or 'http' */
+    transport?: 'stdio' | 'http';
+    /** Port for HTTP transport */
+    port?: number;
+}
+/** Tool registry - map of tool names to definitions */
+export type ToolRegistry = Record<string, ToolDefinition>;
+//# 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":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;CACF;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAChC;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,CAAC,CAAA;IACb,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CAC5D;AAED,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA"}

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

@@ -1,9 +1,37 @@
 {
   "name": "toolcall",
-  "version": "0.0.3",
-  "description": "LLM tool calling utilities",
-  "main": "index.js",
-  "keywords": ["toolcall", "function-calling", "ai", "llm", "agents"],
+  "version": "0.1.0",
+  "description": "FastMCP for JavaScript - Create MCP servers with zero boilerplate",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "ai",
+    "tools",
+    "function-calling",
+    "anthropic",
+    "claude"
+  ],
   "author": "Yi Min Yang (https://www.yiminyang.dev)",
   "license": "MIT",
   "repository": {
@@ -13,5 +41,17 @@
   "homepage": "https://github.com/sceiler/toolcall",
   "bugs": {
     "url": "https://github.com/sceiler/toolcall/issues"
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=18"
   }
 }

package/index.js

@@ -1 +0,0 @@
-module.exports = {};