@selfhost.dev/mcp-server 0.1.0

package/dist/types/api.d.ts

@@ -0,0 +1,20 @@
+export interface ApiSuccessResponse<T> {
+    status: "success";
+    data: T;
+    message: string;
+    status_code: number;
+}
+export interface ApiErrorResponse {
+    status: "error";
+    data: null;
+    message: string;
+    status_code: number;
+}
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+export interface ClientResult<T> {
+    success: boolean;
+    data: T | null;
+    message: string;
+    statusCode: number;
+}
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";

package/dist/types/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":""}

package/dist/types/models.d.ts

@@ -0,0 +1,44 @@
+export interface User {
+    id: string;
+    email: string;
+    display_name: string | null;
+    email_verified: boolean;
+    create_organization: boolean;
+    invite_credits: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface Organization {
+    id: string;
+    name: string;
+    description: string | null;
+    is_creator: boolean;
+    members_count: number;
+    billing_plan: string | null;
+}
+export interface CloudCredential {
+    id: string;
+    name: string;
+    description: string | null;
+    cloud_provider: string;
+    auth_method: string;
+    status: string;
+    is_default: boolean;
+    is_platform_managed: boolean;
+    last_validated_at: string | null;
+    validation_error: string | null;
+    metadata: Record<string, unknown> | null;
+    data_directory: string | null;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        pid: string;
+        email: string;
+        display_name: string | null;
+    } | null;
+    updated_by: {
+        pid: string;
+        email: string;
+        display_name: string | null;
+    } | null;
+}

package/dist/types/models.js

@@ -0,0 +1,3 @@
+// Domain model types — expanded per module
+export {};
+//# sourceMappingURL=models.js.map

package/dist/types/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA,2CAA2C"}

package/dist/types/tiers.d.ts

@@ -0,0 +1,15 @@
+export type TierName = "FREE" | "STARTER" | "PRO" | "ENTERPRISE" | "ADMIN";
+export interface BucketConfig {
+    burst: number;
+    ratePerSecond: number;
+}
+export interface TierConfig {
+    readBucket: BucketConfig;
+    writeBucket: BucketConfig;
+    maxConcurrent: number;
+}
+export declare const TIER_CONFIGS: Record<Exclude<TierName, "ADMIN">, TierConfig>;
+export type OperationCategory = "exempt" | "read" | "write";
+export declare const EXEMPT_TOOLS: Set<string>;
+export declare const WRITE_TOOLS: Set<string>;
+export declare function categorizeOperation(toolName: string): OperationCategory;

package/dist/types/tiers.js

@@ -0,0 +1,91 @@
+export const TIER_CONFIGS = {
+    FREE: {
+        readBucket: { burst: 20, ratePerSecond: 1 },
+        writeBucket: { burst: 10, ratePerSecond: 0.33 },
+        maxConcurrent: 3,
+    },
+    STARTER: {
+        readBucket: { burst: 40, ratePerSecond: 2.5 },
+        writeBucket: { burst: 15, ratePerSecond: 0.83 },
+        maxConcurrent: 5,
+    },
+    PRO: {
+        readBucket: { burst: 80, ratePerSecond: 5 },
+        writeBucket: { burst: 30, ratePerSecond: 2 },
+        maxConcurrent: 10,
+    },
+    ENTERPRISE: {
+        readBucket: { burst: 150, ratePerSecond: 10 },
+        writeBucket: { burst: 50, ratePerSecond: 5 },
+        maxConcurrent: Infinity,
+    },
+};
+export const EXEMPT_TOOLS = new Set([
+    "list_regions",
+    "get_instance_types_for_region",
+    "list_storage_types",
+]);
+export const WRITE_TOOLS = new Set([
+    "create_or_login_user",
+    "send_platform_invite",
+    "create_organization",
+    "update_organization",
+    "delete_organization",
+    "remove_member",
+    "invite_to_org",
+    "cancel_invitation",
+    "add_credential",
+    "update_credential",
+    "delete_credential",
+    "set_default_credential",
+    "create_vpc",
+    "delete_vpc",
+    "create_subnet",
+    "create_security_group",
+    "update_security_group",
+    "create_instance",
+    "update_instance",
+    "stop_instance",
+    "start_instance",
+    "reboot_instance",
+    "delete_instance",
+    "fork_instance",
+    "scale_instance",
+    "resize_instance",
+    "update_pg_config",
+    "create_backup",
+    "delete_backup",
+    "create_backup_policy",
+    "update_backup_policy",
+    "delete_backup_policy",
+    "delete_snapshot",
+    "create_snapshot",
+    "create_alert_rule",
+    "update_alert_rule",
+    "delete_alert_rule",
+    "acknowledge_alert",
+    "resolve_alert",
+    "create_notification_channel",
+    "update_notification_channel",
+    "delete_notification_channel",
+    "test_notification_channel",
+    "create_scaling_policy",
+    "update_scaling_policy",
+    "delete_scaling_policy",
+    "create_webhook",
+    "update_webhook",
+    "delete_webhook",
+    "create_agent_token",
+    "delete_agent_token",
+    "admin_approve_waitlist",
+    "admin_revoke_invitation",
+    "admin_grant_credits",
+]);
+export function categorizeOperation(toolName) {
+    if (EXEMPT_TOOLS.has(toolName))
+        return "exempt";
+    if (WRITE_TOOLS.has(toolName))
+        return "write";
+    return "read";
+}
+//# sourceMappingURL=tiers.js.map

package/dist/types/tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/types/tiers.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,YAAY,GAAmD;IAC1E,IAAI,EAAE;QACJ,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;QAC3C,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;QAC/C,aAAa,EAAE,CAAC;KACjB;IACD,OAAO,EAAE;QACP,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE;QAC7C,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;QAC/C,aAAa,EAAE,CAAC;KACjB;IACD,GAAG,EAAE;QACH,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;QAC3C,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;QAC5C,aAAa,EAAE,EAAE;KAClB;IACD,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE;QAC7C,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE;QAC5C,aAAa,EAAE,QAAQ;KACxB;CACF,CAAC;AAIF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,cAAc;IACd,+BAA+B;IAC/B,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,mBAAmB;IACnB,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,wBAAwB;IACxB,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,uBAAuB;IACvB,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,eAAe;IACf,6BAA6B;IAC7B,6BAA6B;IAC7B,6BAA6B;IAC7B,2BAA2B;IAC3B,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,wBAAwB;IACxB,yBAAyB;IACzB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/formatters.d.ts

@@ -0,0 +1 @@
+export declare function stripSensitiveFields(obj: unknown): unknown;

package/dist/utils/formatters.js

@@ -0,0 +1,28 @@
+const SENSITIVE_KEYS = new Set([
+    "init_pg_pass",
+    "shdev_admin_pass",
+    "repl_admin_pass",
+    "credential_data",
+    "token_key",
+    "secret",
+]);
+export function stripSensitiveFields(obj) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj)) {
+        return obj.map(stripSensitiveFields);
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (SENSITIVE_KEYS.has(key)) {
+            result[key] = "[REDACTED]";
+        }
+        else {
+            result[key] = stripSensitiveFields(value);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,cAAc;IACd,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAExC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/validators.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const pidSchema: z.ZodString;
+export declare const orgPidSchema: z.ZodString;
+export declare const instancePidSchema: z.ZodString;
+export declare const paginationSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    items: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page?: number | undefined;
+    items?: number | undefined;
+}, {
+    page?: number | undefined;
+    items?: number | undefined;
+}>;

package/dist/utils/validators.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export const pidSchema = z.string().min(1, "PID is required");
+export const orgPidSchema = z.string().min(1, "Organization PID is required");
+export const instancePidSchema = z.string().min(1, "Instance PID is required");
+export const paginationSchema = z.object({
+    page: z.number().int().positive().optional(),
+    items: z.number().int().min(1).max(100).optional(),
+});
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@selfhost.dev/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for SelfHost.dev — Manage Database Infrastructure via Natural Language",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "selfhost-mcp": "dist/index.js",
+    "@selfhost.dev/mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "selfhost",
+    "database",
+    "postgres",
+    "aws",
+    "claude",
+    "cursor",
+    "managed databases",
+    "cloud databases",
+    "cheap managed databases",
+    "cost efficient managed databases",
+    "SelfHost",
+    "cloudSql"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "dotenv": "^16.5.0",
+    "open": "^10.1.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3"
+  }
+}