@achmadya-dev/mcp-core 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 achmadya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @achmadya-dev/mcp-core
+
+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.
+
+## Install
+
+```bash
+pnpm add @achmadya-dev/mcp-core zod
+```
+
+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`:
+
+```typescript
+import * as z from "zod";
+import { defineTool, startMcpServer, envStr, type ToolDefinition } from "@achmadya-dev/mcp-core";
+
+const myTool = defineTool({
+  name: "my_tool",
+  description: "Does something",
+  inputSchema: z.object({
+    name: z.string().describe("Item name"),
+  }),
+  outputSchema: z.object({
+    ok: z.boolean(),
+  }),
+  handler: async ({ name }) => ({ ok: true }),
+});
+
+await startMcpServer({
+  name: "My MCP",
+  version: "1.0.0",
+  tools: [myTool],
+});
+```
+
+Tools with no parameters:
+
+```typescript
+defineTool({
+  name: "ping",
+  description: "Health check",
+  inputSchema: z.object({}),
+  handler: async () => ({ status: "ok" }),
+});
+```
+
+## Exports
+
+- `Server`, `defineTool`, `ToolError`, `startMcpServer`
+- `envStr`, `envInt`, `envBool`
+- Types: `ToolDefinition`, `ToolInput`, `JsonValue`, `RegisterableTool`, `ServerConfig`, `StandardSchemaWithJSON`, …
+
+Schema builders and runtime validation stay in each `@achmadya-dev/mcp-*` package.
+
+## Release
+
+Uses [Changesets](https://github.com/changesets/changesets) — same flow as [`achmadya-dev/mcp`](https://github.com/achmadya-dev/mcp).
+
+1. Add a changeset when you ship user-facing changes:
+
+   ```bash
+   pnpm changeset
+   ```
+
+2. Push to `main`. GitHub Actions opens a **Version packages** PR (version bump + `CHANGELOG.md`).
+
+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`).

package/dist/env.d.ts

@@ -0,0 +1,4 @@
+export declare function envBool(name: string, defaultVal?: boolean): boolean;
+export declare function envInt(name: string, defaultVal: number, min?: number): number;
+export declare function envStr(name: string, defaultVal?: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAIjE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,CAKxE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,MAAM,CAK5D"}

package/dist/env.js

@@ -0,0 +1,21 @@
+export function envBool(name, defaultVal = false) {
+    const v = Reflect.get(process.env, name);
+    if (v === undefined)
+        return defaultVal;
+    return ["1", "true", "yes", "on"].includes(v.trim().toLowerCase());
+}
+export function envInt(name, defaultVal, min = 1) {
+    const raw = Reflect.get(process.env, name);
+    if (raw === undefined)
+        return defaultVal;
+    const n = parseInt(raw, 10);
+    return Number.isNaN(n) || n < min ? defaultVal : n;
+}
+export function envStr(name, defaultVal = "") {
+    const raw = Reflect.get(process.env, name);
+    if (raw === undefined)
+        return defaultVal;
+    const v = raw.trim();
+    return v || defaultVal;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,UAAU,GAAG,KAAK;IACtD,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,UAAkB,EAAE,GAAG,GAAG,CAAC;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,UAAU,GAAG,EAAE;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IACzC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,UAAU,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Server, ToolError, defineTool, startMcpServer } from "./server.js";
+export { envBool, envInt, envStr } from "./env.js";
+export type { JsonArray, JsonObject, JsonPrimitive, JsonValue, RegisterableTool, ServerConfig, StandardSchemaWithJSON, ToolDefinition, ToolInput, } 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,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Server, ToolError, defineTool, startMcpServer } from "./server.js";
+export { envBool, envInt, envStr } from "./env.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,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { type StandardSchemaWithJSON, type Transport } from "@modelcontextprotocol/server";
+import type { JsonObject, JsonValue, RegisterableTool, ServerConfig, ToolDefinition } from "./types.js";
+export declare class ToolError extends Error {
+    constructor(message: string);
+}
+export declare function defineTool<TInput extends StandardSchemaWithJSON, TResult extends JsonValue | void = JsonObject>(definition: ToolDefinition<TInput, TResult>): RegisterableTool;
+export declare class Server {
+    private readonly server;
+    private started;
+    constructor(config: ServerConfig);
+    registerTool<TInput extends StandardSchemaWithJSON, TResult extends JsonValue | void = JsonValue>(definition: ToolDefinition<TInput, TResult>): void;
+    connect(transport: Transport): Promise<void>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function startMcpServer(options: {
+    name: string;
+    version: string;
+    tools: readonly RegisterableTool[];
+}): Promise<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,EAIL,KAAK,sBAAsB,EAE3B,KAAK,SAAS,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAwBD,wBAAgB,UAAU,CACxB,MAAM,SAAS,sBAAsB,EACrC,OAAO,SAAS,SAAS,GAAG,IAAI,GAAG,UAAU,EAC7C,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAE/D;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAOhC,YAAY,CACV,MAAM,SAAS,sBAAsB,EACrC,OAAO,SAAS,SAAS,GAAG,IAAI,GAAG,SAAS,EAC5C,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IA6C9C,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB"}

package/dist/server.js

@@ -0,0 +1,110 @@
+import { McpServer as SdkMcpServer, StdioServerTransport, } from "@modelcontextprotocol/server";
+export class ToolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ToolError";
+    }
+}
+function toJsonSafe(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "bigint")
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Buffer.isBuffer(value))
+        return value.toString("base64");
+    if (Array.isArray(value))
+        return value.map(toJsonSafe);
+    if (typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (k === "__proto__" || k === "constructor" || k === "prototype") {
+                continue;
+            }
+            Reflect.set(out, k, toJsonSafe(v));
+        }
+        return out;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    return String(value);
+}
+export function defineTool(definition) {
+    return definition;
+}
+export class Server {
+    server;
+    started = false;
+    constructor(config) {
+        this.server = new SdkMcpServer({
+            name: config.name,
+            version: config.version,
+        });
+    }
+    registerTool(definition) {
+        const config = {
+            title: definition.name,
+            description: definition.description,
+            inputSchema: definition.inputSchema,
+            ...(definition.outputSchema !== undefined ? { outputSchema: definition.outputSchema } : {}),
+        };
+        const handler = definition.handler;
+        const onCall = async (args) => {
+            try {
+                const result = await handler(args);
+                const hasOutputSchema = definition.outputSchema !== undefined;
+                if (hasOutputSchema) {
+                    if (result == null) {
+                        throw new ToolError("Tool handler returned no result.");
+                    }
+                    const structured = toJsonSafe(result);
+                    const text = JSON.stringify(structured, null, 2);
+                    return {
+                        content: [{ type: "text", text }],
+                        structuredContent: structured,
+                    };
+                }
+                const text = result == null
+                    ? "{}"
+                    : typeof result === "string"
+                        ? result
+                        : JSON.stringify(toJsonSafe(result), null, 2);
+                return { content: [{ type: "text", text }] };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Unknown error";
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: message }],
+                };
+            }
+        };
+        this.server.registerTool(definition.name, config, onCall);
+    }
+    async connect(transport) {
+        await this.server.connect(transport);
+    }
+    async start() {
+        if (this.started)
+            return;
+        await this.connect(new StdioServerTransport());
+        this.started = true;
+    }
+    async close() {
+        await this.server.close();
+        this.started = false;
+    }
+}
+export async function startMcpServer(options) {
+    const server = new Server({
+        name: options.name,
+        version: options.version,
+    });
+    for (const tool of options.tools) {
+        server.registerTool(tool);
+    }
+    await server.start();
+}
+//# 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/types.d.ts

@@ -0,0 +1,26 @@
+import type { StandardSchemaWithJSON } from "@modelcontextprotocol/server";
+export type { StandardSchemaWithJSON };
+/** Parsed tool handler args from a Standard Schema input. */
+export type ToolInput<S extends StandardSchemaWithJSON> = StandardSchemaWithJSON.InferOutput<S>;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JsonArray = JsonValue[];
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export interface ServerConfig {
+    name: string;
+    version: string;
+}
+type BivariantHandler<TInput extends StandardSchemaWithJSON, TResult extends JsonValue | void> = {
+    bivarianceHack(args: ToolInput<TInput>): Promise<TResult> | TResult;
+}["bivarianceHack"];
+export interface ToolDefinition<TInput extends StandardSchemaWithJSON = StandardSchemaWithJSON, TResult extends JsonValue | void = JsonObject> {
+    name: string;
+    description: string;
+    inputSchema: TInput;
+    outputSchema?: StandardSchemaWithJSON;
+    handler: BivariantHandler<TInput, TResult>;
+}
+export type RegisterableTool = ToolDefinition<StandardSchemaWithJSON, JsonValue | void>;
+//# 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,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,sBAAsB,IACpD,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AACpC,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,gBAAgB,CACnB,MAAM,SAAS,sBAAsB,EACrC,OAAO,SAAS,SAAS,GAAG,IAAI,IAC9B;IACF,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACrE,CAAC,gBAAgB,CAAC,CAAC;AAEpB,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,OAAO,SAAS,SAAS,GAAG,IAAI,GAAG,UAAU;IAE7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,sBAAsB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC"}

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,51 @@
+{
+  "name": "@achmadya-dev/mcp-core",
+  "version": "0.3.0",
+  "description": "Shared MCP server runtime, types, and env helpers for @achmadya-dev MCP packages",
+  "type": "module",
+  "author": "achmadya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/achmadya-dev/mcp-core.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "core"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "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": {
+    "@modelcontextprotocol/server": "2.0.0-alpha.2"
+  },
+  "devDependencies": {
+    "@changesets/cli": "2.29.8",
+    "@types/node": "22.10.0",
+    "typescript": "5.7.2"
+  },
+  "packageManager": "pnpm@10.33.0"
+}