@achmadya-dev/mcp-core 0.3.0 → 0.3.3

package/README.md

@@ -2,23 +2,30 @@
 
 Shared MCP SDK wrapper for `@achmadya-dev` servers: stdio transport, tool registration, JSON-safe responses, and env helpers.
 
-Built on **MCP TypeScript SDK v2** (`@modelcontextprotocol/server`). Tool schemas use [Standard Schema](https://standardschema.dev/) — Zod v4 works natively with MCP.
+Built on **MCP TypeScript SDK v2** (`@modelcontextprotocol/server`). Tool schemas use [Standard Schema](https://standardschema.dev/) — pick any compatible library in your package.
 
 ## Install
 
 ```bash
-pnpm add @achmadya-dev/mcp-core zod
+pnpm add @achmadya-dev/mcp-core
+# plus a Standard Schema library in your MCP package, e.g. zod, valibot, arktype, …
 ```
 
 Installed automatically as a dependency of `@achmadya-dev/mcp-*-query` servers.
 
 ## Usage
 
-Zod v4 implements Standard Schema natively — pass `z.object(...)` directly to `inputSchema` / `outputSchema`:
+Pass a Standard Schema object to `inputSchema` / `outputSchema`. Examples below use the same tool shape; only the schema library differs.
+
+### Zod
+
+```bash
+pnpm add zod
+```
 
 ```typescript
 import * as z from "zod";
-import { defineTool, startMcpServer, envStr, type ToolDefinition } from "@achmadya-dev/mcp-core";
+import { defineTool, startMcpServer } from "@achmadya-dev/mcp-core";
 
 const myTool = defineTool({
   name: "my_tool",
@@ -26,30 +33,78 @@ const myTool = defineTool({
   inputSchema: z.object({
     name: z.string().describe("Item name"),
   }),
-  outputSchema: z.object({
-    ok: z.boolean(),
-  }),
+  outputSchema: z.object({ ok: z.boolean() }),
+  handler: async ({ name }) => ({ ok: true }),
+});
+
+await startMcpServer({ name: "My MCP", version: "1.0.0", tools: [myTool] });
+```
+
+### Valibot
+
+```bash
+pnpm add valibot @valibot/to-json-schema
+```
+
+```typescript
+import * as v from "valibot";
+import { toStandardJsonSchema } from "@valibot/to-json-schema";
+import { defineTool, startMcpServer } from "@achmadya-dev/mcp-core";
+
+const myTool = defineTool({
+  name: "my_tool",
+  description: "Does something",
+  inputSchema: toStandardJsonSchema(
+    v.object({ name: v.pipe(v.string(), v.description("Item name")) })
+  ),
+  outputSchema: toStandardJsonSchema(v.object({ ok: v.boolean() })),
   handler: async ({ name }) => ({ ok: true }),
 });
 
-await startMcpServer({
-  name: "My MCP",
-  version: "1.0.0",
-  tools: [myTool],
+await startMcpServer({ name: "My MCP", version: "1.0.0", tools: [myTool] });
+```
+
+### Other (ArkType, JSON Schema, …)
+
+**ArkType** — Standard Schema native:
+
+```bash
+pnpm add arktype
+```
+
+```typescript
+import { type } from "arktype";
+import { defineTool, startMcpServer } from "@achmadya-dev/mcp-core";
+
+defineTool({
+  name: "my_tool",
+  description: "Does something",
+  inputSchema: type({ name: "string" }),
+  outputSchema: type({ ok: "boolean" }),
+  handler: async ({ name }) => ({ ok: true }),
 });
 ```
 
-Tools with no parameters:
+**Raw JSON Schema** — via MCP SDK adapter:
 
 ```typescript
+import { fromJsonSchema } from "@modelcontextprotocol/server";
+import { defineTool } from "@achmadya-dev/mcp-core";
+
 defineTool({
-  name: "ping",
-  description: "Health check",
-  inputSchema: z.object({}),
-  handler: async () => ({ status: "ok" }),
+  name: "my_tool",
+  description: "Does something",
+  inputSchema: fromJsonSchema({
+    type: "object",
+    properties: { name: { type: "string", description: "Item name" } },
+    required: ["name"],
+  }),
+  handler: async ({ name }) => ({ ok: true }),
 });
 ```
 
+Tools with no parameters: use an empty object schema from your library (e.g. `z.object({})`, `toStandardJsonSchema(v.object({}))`, `type({})`).
+
 ## Exports
 
 - `Server`, `defineTool`, `ToolError`, `startMcpServer`
@@ -72,4 +127,4 @@ Uses [Changesets](https://github.com/changesets/changesets) — same flow as [`a
 
 3. Merge that PR. Next push to `main` publishes to npm (`@achmadya-dev/mcp-core`).
 
-**Remote prerequisites:** GitHub secret `NPM_TOKEN` (npm automation token with publish access to `@achmadya-dev`).
+**Remote prerequisites:** GitHub secret `NPM_TOKEN` (npm automation token with bypass 2FA for `@achmadya-dev`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@achmadya-dev/mcp-core",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Shared MCP server runtime, types, and env helpers for @achmadya-dev MCP packages",
   "type": "module",
   "author": "achmadya",
@@ -28,18 +28,11 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "prepare": "pnpm run build",
-    "prepublishOnly": "pnpm run build",
-    "changeset": "changeset",
-    "version-packages": "changeset version",
-    "publish-packages": "pnpm run build && changeset publish"
-  },
   "engines": {
     "node": ">=20"
   },
   "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
     "@modelcontextprotocol/server": "2.0.0-alpha.2"
   },
   "devDependencies": {
@@ -47,5 +40,10 @@
     "@types/node": "22.10.0",
     "typescript": "5.7.2"
   },
-  "packageManager": "pnpm@10.33.0"
-}
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "publish-packages": "pnpm run build && changeset publish"
+  }
+}