bostrom-mcp 0.1.0

package/dist/util.d.ts

@@ -0,0 +1,31 @@
+/** BigInt-safe JSON serializer with pretty-printing */
+export declare function jsonStringify(obj: unknown): string;
+/** Format a successful tool response, truncating if too large */
+export declare function ok(data: unknown): ToolResult;
+/** Format an error tool response */
+export declare function err(message: string): ToolResult;
+/** Wrap a tool handler with try/catch error handling */
+export declare function safe<T>(fn: (args: T) => Promise<ToolResult>): (args: T) => Promise<ToolResult>;
+/** Build pagination hint for list-returning tools */
+export declare function paginationHint(toolName: string, currentOffset: number, limit: number, totalOrItems: number | unknown[]): PaginationHint | null;
+export interface PaginationHint {
+    next_call: {
+        tool: string;
+        params: Record<string, unknown>;
+    };
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Read-only tool annotations (all our tools are read-only) */
+export declare const READ_ONLY_ANNOTATIONS: {
+    readOnlyHint: true;
+    destructiveHint: false;
+    idempotentHint: true;
+    openWorldHint: true;
+};

package/dist/util.js

@@ -0,0 +1,72 @@
+/** BigInt-safe JSON serializer with pretty-printing */
+export function jsonStringify(obj) {
+    return JSON.stringify(obj, (_key, value) => (typeof value === "bigint" ? value.toString() : value), 2);
+}
+const MAX_RESPONSE_CHARS = 40_000;
+const MAX_STRING_VALUE_CHARS = 2_000;
+/** Recursively truncate long string values inside an object */
+function truncateDeep(data) {
+    if (typeof data === "string") {
+        if (data.length > MAX_STRING_VALUE_CHARS) {
+            return data.slice(0, MAX_STRING_VALUE_CHARS) + "… (truncated)";
+        }
+        return data;
+    }
+    if (Array.isArray(data))
+        return data.map(truncateDeep);
+    if (data !== null && typeof data === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(data)) {
+            out[k] = truncateDeep(v);
+        }
+        return out;
+    }
+    return data;
+}
+/** Format a successful tool response, truncating if too large */
+export function ok(data) {
+    let text = jsonStringify(truncateDeep(data));
+    if (text.length > MAX_RESPONSE_CHARS) {
+        text = text.slice(0, MAX_RESPONSE_CHARS) + "\n… (response truncated)";
+    }
+    return { content: [{ type: "text", text }] };
+}
+/** Format an error tool response */
+export function err(message) {
+    return {
+        content: [{ type: "text", text: message.slice(0, 4_000) }],
+        isError: true,
+    };
+}
+/** Wrap a tool handler with try/catch error handling */
+export function safe(fn) {
+    return async (args) => {
+        try {
+            return await fn(args);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return err(msg);
+        }
+    };
+}
+/** Build pagination hint for list-returning tools */
+export function paginationHint(toolName, currentOffset, limit, totalOrItems) {
+    const count = typeof totalOrItems === "number" ? totalOrItems : totalOrItems.length;
+    if (count < limit)
+        return null;
+    return {
+        next_call: {
+            tool: toolName,
+            params: { offset: currentOffset + limit, limit },
+        },
+    };
+}
+/** Read-only tool annotations (all our tools are read-only) */
+export const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "bostrom-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for read-only access to the Bostrom blockchain ecosystem",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bostrom-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyberia-to/bostrom-mcp"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "bostrom",
+    "cyber",
+    "blockchain",
+    "cosmwasm",
+    "lithium"
+  ],
+  "mcpName": "io.github.cyberia-to/bostrom-mcp",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "@types/node": "^22.15.3"
+  }
+}