@thantos66/claude-context-mcp 0.1.0

package/dist/services/skills.js

@@ -0,0 +1,181 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import matter from "gray-matter";
+import { SkillFrontmatterSchema, } from "../schemas/skill-frontmatter.js";
+import { atomicWriteFile } from "./atomic-write.js";
+import { backupFile, backupDir } from "./backup.js";
+import { skillsDirFor } from "./paths.js";
+/** List all skill folders under the scope's skills dir. */
+export async function listSkills(scope, projectPath) {
+    const dir = skillsDirFor(scope, projectPath);
+    let names;
+    try {
+        names = await fs.readdir(dir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const results = [];
+    for (const name of names) {
+        const skillDir = path.join(dir, name);
+        const stat = await fs.stat(skillDir).catch(() => null);
+        if (!stat?.isDirectory())
+            continue;
+        try {
+            const rec = await readSkillFolder(scope, skillDir);
+            results.push(rec);
+        }
+        catch {
+            continue; // skip malformed skills
+        }
+    }
+    return results;
+}
+async function readSkillFolder(scope, skillDir) {
+    const skillMdPath = path.join(skillDir, "SKILL.md");
+    const raw = await fs.readFile(skillMdPath, "utf8");
+    const parsed = matter(raw);
+    const frontmatter = SkillFrontmatterSchema.parse(parsed.data);
+    return {
+        scope,
+        name: frontmatter.name,
+        dir: skillDir,
+        skillMdPath,
+        frontmatter,
+        body: parsed.content.trimStart(),
+    };
+}
+export async function getSkill(params) {
+    const skillDir = path.join(skillsDirFor(params.scope, params.projectPath), params.name);
+    try {
+        return await readSkillFolder(params.scope, skillDir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+/** Serialize a skill record to SKILL.md contents. */
+export function serializeSkill(frontmatter, body) {
+    const ordered = {
+        name: frontmatter.name,
+        description: frontmatter.description,
+    };
+    const knownOrder = [
+        "allowed-tools",
+        "disable-model-invocation",
+        "user-invocable",
+        "model",
+        "effort",
+        "context",
+        "paths",
+    ];
+    for (const k of knownOrder) {
+        const v = frontmatter[k];
+        if (v !== undefined)
+            ordered[k] = v;
+    }
+    for (const [k, v] of Object.entries(frontmatter)) {
+        if (v === undefined)
+            continue;
+        if (!(k in ordered))
+            ordered[k] = v;
+    }
+    const bodyText = body.endsWith("\n") ? body : body + "\n";
+    return matter.stringify(bodyText, ordered);
+}
+/** Scaffold a new skill folder with a SKILL.md. */
+export async function createSkill(params) {
+    const frontmatter = SkillFrontmatterSchema.parse({
+        name: params.name,
+        description: params.description,
+        ...(params.allowedTools !== undefined && { "allowed-tools": params.allowedTools }),
+        ...(params.model !== undefined && { model: params.model }),
+    });
+    const body = params.body ?? `# ${frontmatter.name}\n\n${frontmatter.description}\n`;
+    const skillDir = path.join(skillsDirFor(params.scope, params.projectPath), frontmatter.name);
+    const skillMdPath = path.join(skillDir, "SKILL.md");
+    if (!params.overwrite) {
+        try {
+            await fs.access(skillMdPath);
+            throw new Error(`Skill "${frontmatter.name}" already exists at ${skillDir}. Pass overwrite: true to replace.`);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+    }
+    const contents = serializeSkill(frontmatter, body);
+    if (params.dryRun) {
+        return { path: skillMdPath, backup: null, dryRun: true, preview: contents };
+    }
+    await fs.mkdir(skillDir, { recursive: true });
+    const backup = await backupFile(skillMdPath);
+    await atomicWriteFile(skillMdPath, contents);
+    return { path: skillMdPath, backup, dryRun: false };
+}
+/** Patch frontmatter fields or replace the SKILL.md body. */
+export async function updateSkill(params) {
+    const current = await getSkill({
+        scope: params.scope,
+        name: params.name,
+        projectPath: params.projectPath,
+    });
+    if (!current)
+        throw new Error(`Skill "${params.name}" not found in scope ${params.scope}.`);
+    const merged = SkillFrontmatterSchema.parse({
+        ...current.frontmatter,
+        ...(params.description !== undefined && { description: params.description }),
+        ...(params.allowedTools !== undefined && { "allowed-tools": params.allowedTools }),
+        ...(params.model !== undefined && { model: params.model }),
+    });
+    const body = params.body ?? current.body;
+    const contents = serializeSkill(merged, body);
+    if (params.dryRun) {
+        return { path: current.skillMdPath, backup: null, dryRun: true, preview: contents };
+    }
+    const backup = await backupFile(current.skillMdPath);
+    await atomicWriteFile(current.skillMdPath, contents);
+    return { path: current.skillMdPath, backup, dryRun: false };
+}
+/** Toggle `disable-model-invocation` flag while preserving files. */
+export async function setSkillEnabled(params) {
+    const current = await getSkill({
+        scope: params.scope,
+        name: params.name,
+        projectPath: params.projectPath,
+    });
+    if (!current)
+        throw new Error(`Skill "${params.name}" not found in scope ${params.scope}.`);
+    const merged = SkillFrontmatterSchema.parse({
+        ...current.frontmatter,
+        "disable-model-invocation": !params.enabled,
+    });
+    const contents = serializeSkill(merged, current.body);
+    if (params.dryRun) {
+        return { path: current.skillMdPath, backup: null, dryRun: true, preview: contents };
+    }
+    const backup = await backupFile(current.skillMdPath);
+    await atomicWriteFile(current.skillMdPath, contents);
+    return { path: current.skillMdPath, backup, dryRun: false };
+}
+/** Remove a skill folder entirely. Backs up the full directory first. */
+export async function deleteSkill(params) {
+    const current = await getSkill({
+        scope: params.scope,
+        name: params.name,
+        projectPath: params.projectPath,
+    });
+    if (!current)
+        throw new Error(`Skill "${params.name}" not found in scope ${params.scope}.`);
+    if (params.dryRun) {
+        return { path: current.dir, backup: null, dryRun: true };
+    }
+    const backup = await backupDir(current.dir);
+    await fs.rm(current.dir, { recursive: true, force: true });
+    return { path: current.dir, backup, dryRun: false };
+}
+//# sourceMappingURL=skills.js.map

package/dist/services/skills.js.map

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

package/dist/tools/agents.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAgentTools(server: McpServer): void;

package/dist/tools/agents.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+import { listAgents, getAgent, createAgent, updateAgent, deleteAgent, } from "../services/agents.js";
+import { handle, okResponse, formatWriteResult } from "./helpers.js";
+const CodeScope = z.enum(["user", "project"]);
+const ProjectPathField = {
+    projectPath: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project. Required when scope=project."),
+};
+const DryRunField = {
+    dryRun: z.boolean().optional(),
+};
+export function registerAgentTools(server) {
+    // ------------------------------------------------------------------
+    // agent_list
+    // ------------------------------------------------------------------
+    server.registerTool("agent_list", {
+        title: "List subagents",
+        description: "List subagents in a scope with their name and description.",
+        inputSchema: {
+            scope: CodeScope,
+            ...ProjectPathField,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ scope, projectPath }) => handle(() => listAgents(scope, projectPath), (agents) => okResponse(agents.length === 0
+        ? `No agents found in ${scope} scope.`
+        : agents
+            .map((a) => `[${a.scope}] ${a.name}\n  path: ${a.path}\n  description: ${truncate(a.frontmatter.description, 120)}`)
+            .join("\n\n"), { agents: agents.map((a) => ({ ...a, body: truncate(a.body, 200) })) })));
+    // ------------------------------------------------------------------
+    // agent_get
+    // ------------------------------------------------------------------
+    server.registerTool("agent_get", {
+        title: "Get a subagent",
+        description: "Return a subagent's full frontmatter and body.",
+        inputSchema: {
+            scope: CodeScope,
+            name: z.string().min(1),
+            ...ProjectPathField,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => getAgent(args), (rec) => rec
+        ? okResponse(`[${rec.scope}] ${rec.name}\n  path: ${rec.path}\n\n--- frontmatter ---\n${JSON.stringify(rec.frontmatter, null, 2)}\n\n--- body ---\n${rec.body}`, { agent: rec })
+        : okResponse(`Agent "${args.name}" not found.`, { found: false })));
+    // ------------------------------------------------------------------
+    // agent_create
+    // ------------------------------------------------------------------
+    server.registerTool("agent_create", {
+        title: "Create a subagent",
+        description: "Scaffold a new subagent markdown file. `tools` accepts either a " +
+            "comma-separated string or a string array; it will be written as " +
+            "comma-separated on disk.",
+        inputSchema: {
+            scope: CodeScope,
+            name: z
+                .string()
+                .regex(/^[a-z0-9][a-z0-9-]*$/, "agent name must be lowercase alphanumeric + hyphens"),
+            description: z.string().min(1),
+            model: z.string().optional(),
+            tools: z.union([z.string(), z.array(z.string())]).optional(),
+            color: z.string().optional(),
+            body: z.string().optional(),
+            overwrite: z.boolean().optional(),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => createAgent(args), (result) => okResponse(formatWriteResult(result, `create agent "${args.name}" at`, false), { result })));
+    // ------------------------------------------------------------------
+    // agent_update
+    // ------------------------------------------------------------------
+    server.registerTool("agent_update", {
+        title: "Update a subagent",
+        description: "Patch frontmatter fields and/or replace the body of an existing agent.",
+        inputSchema: {
+            scope: CodeScope,
+            name: z.string().min(1),
+            description: z.string().optional(),
+            model: z.string().optional(),
+            tools: z.union([z.string(), z.array(z.string())]).optional(),
+            color: z.string().optional(),
+            body: z.string().optional(),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => updateAgent(args), (result) => okResponse(formatWriteResult(result, `update agent "${args.name}" at`, false), { result })));
+    // ------------------------------------------------------------------
+    // agent_delete
+    // ------------------------------------------------------------------
+    server.registerTool("agent_delete", {
+        title: "Delete a subagent",
+        description: "Delete a subagent markdown file. Backed up first.",
+        inputSchema: {
+            scope: CodeScope,
+            name: z.string().min(1),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => deleteAgent(args), (result) => okResponse(formatWriteResult(result, `delete agent "${args.name}" at`, false), { result })));
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + "…";
+}
+//# sourceMappingURL=agents.js.map

package/dist/tools/agents.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared helpers for tool handlers: building MCP tool responses with
+ * both a human-readable text block and structured JSON for modern clients.
+ */
+export interface ToolResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export declare function okResponse(text: string, structured?: Record<string, unknown>): ToolResponse;
+export declare function errorResponse(err: unknown): ToolResponse;
+/** Wrap an async handler to catch thrown errors into MCP error responses. */
+export declare function handle<T>(fn: () => Promise<T>, render: (value: T) => ToolResponse): Promise<ToolResponse>;
+/** Build a human-readable write-result summary line. */
+export declare function formatWriteResult(result: {
+    path: string;
+    backup: string | null;
+    dryRun: boolean;
+    diff?: string;
+    preview?: string;
+}, verb: string, restartRequired?: boolean): string;

package/dist/tools/helpers.js

@@ -0,0 +1,36 @@
+export function okResponse(text, structured) {
+    return {
+        content: [{ type: "text", text }],
+        ...(structured && { structuredContent: structured }),
+    };
+}
+export function errorResponse(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: "text", text: `Error: ${msg}` }],
+        isError: true,
+    };
+}
+/** Wrap an async handler to catch thrown errors into MCP error responses. */
+export function handle(fn, render) {
+    return fn().then(render, (err) => errorResponse(err));
+}
+/** Build a human-readable write-result summary line. */
+export function formatWriteResult(result, verb, restartRequired = false) {
+    if (result.dryRun) {
+        const head = `[dry-run] would ${verb} ${result.path}`;
+        if (result.diff)
+            return `${head}\n\n${result.diff}`;
+        if (result.preview)
+            return `${head}\n\n${result.preview}`;
+        return head;
+    }
+    const lines = [`${verb} ${result.path}`];
+    if (result.backup)
+        lines.push(`  backup: ${result.backup}`);
+    if (restartRequired) {
+        lines.push("  NOTE: Claude Desktop must be fully quit and relaunched for this change to take effect.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,UAAoC;IAEpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,GAAG,CAAC,UAAU,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,CAAC;QAClD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,MAAM,CACpB,EAAoB,EACpB,MAAkC;IAElC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,iBAAiB,CAC/B,MAAiG,EACjG,IAAY,EACZ,eAAe,GAAG,KAAK;IAEvB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,mBAAmB,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,MAAM,CAAC,IAAI;YAAE,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CACR,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/mcp.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMcpTools(server: McpServer): void;

package/dist/tools/mcp.js

@@ -0,0 +1,257 @@
+import { z } from "zod";
+import { listServers, getServer, addServer, updateServer, removeServer, setServerDisabled, } from "../services/mcp-config.js";
+import { StdioServerSchema, HttpServerSchema, } from "../schemas/mcp-config.js";
+import { handle, okResponse, formatWriteResult } from "./helpers.js";
+const ScopeSchema = z.enum(["desktop", "user", "project"]);
+const WritableScopeSchema = ScopeSchema;
+const ProjectPathField = {
+    projectPath: z
+        .string()
+        .optional()
+        .describe("Absolute path to the project. Required when scope=project."),
+};
+const DryRunField = {
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe("If true, return the diff of what would be written without touching disk."),
+};
+export function registerMcpTools(server) {
+    // ------------------------------------------------------------------
+    // mcp_list_servers
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_list_servers", {
+        title: "List MCP servers",
+        description: "List configured MCP servers across scopes (desktop, user, project). " +
+            "Secret-looking env values are redacted unless revealSecrets=true.",
+        inputSchema: {
+            scope: ScopeSchema
+                .optional()
+                .describe("If omitted, list across all applicable scopes."),
+            ...ProjectPathField,
+            revealSecrets: z.boolean().optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ scope, projectPath, revealSecrets }) => {
+        return handle(async () => {
+            const scopes = scope
+                ? [scope]
+                : projectPath
+                    ? ["desktop", "user", "project"]
+                    : ["desktop", "user"];
+            const all = [];
+            for (const s of scopes) {
+                try {
+                    const list = await listServers(s, {
+                        projectPath,
+                        revealSecrets,
+                    });
+                    all.push(...list);
+                }
+                catch (err) {
+                    // Non-fatal: scope may not be configured yet.
+                    all.push({
+                        scope: s,
+                        name: "[error]",
+                        path: "",
+                        entry: { error: err.message },
+                    });
+                }
+            }
+            return all;
+        }, (entries) => okResponse(entries.length === 0
+            ? "No MCP servers found."
+            : entries
+                .map((e) => `[${e.scope}] ${e.name}\n  path: ${e.path}\n  entry: ${JSON.stringify(e.entry)}`)
+                .join("\n\n"), { servers: entries }));
+    });
+    // ------------------------------------------------------------------
+    // mcp_get_server
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_get_server", {
+        title: "Get one MCP server",
+        description: "Return the full config of a single MCP server by name and scope.",
+        inputSchema: {
+            scope: ScopeSchema,
+            name: z.string().min(1),
+            ...ProjectPathField,
+            revealSecrets: z.boolean().optional(),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ scope, name, projectPath, revealSecrets }) => handle(() => getServer({ scope, name, projectPath, revealSecrets }), (entry) => entry
+        ? okResponse(`[${entry.scope}] ${entry.name}\n  path: ${entry.path}\n  entry: ${JSON.stringify(entry.entry, null, 2)}`, { server: entry })
+        : okResponse(`Server "${name}" not found in scope ${scope}.`, {
+            found: false,
+        })));
+    // ------------------------------------------------------------------
+    // mcp_add_server
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_add_server", {
+        title: "Add or replace an MCP server",
+        description: "Add a new MCP server entry. Provide either (command + args/env) for stdio " +
+            "or url + headers for HTTP transports. Use overwrite=true to replace an existing entry.",
+        inputSchema: {
+            scope: WritableScopeSchema,
+            name: z
+                .string()
+                .regex(/^[A-Za-z0-9_-]+$/, "server name must be alphanumeric/underscore/hyphen"),
+            command: z.string().optional(),
+            args: z.array(z.string()).optional(),
+            env: z.record(z.string()).optional(),
+            cwd: z.string().optional(),
+            url: z.string().url().optional(),
+            headers: z.record(z.string()).optional(),
+            overwrite: z.boolean().optional(),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        return handle(async () => {
+            const entry = args.url
+                ? HttpServerSchema.parse({
+                    url: args.url,
+                    ...(args.headers && { headers: args.headers }),
+                })
+                : StdioServerSchema.parse({
+                    command: args.command,
+                    ...(args.args && { args: args.args }),
+                    ...(args.env && { env: args.env }),
+                    ...(args.cwd && { cwd: args.cwd }),
+                });
+            return addServer({
+                scope: args.scope,
+                name: args.name,
+                entry,
+                projectPath: args.projectPath,
+                overwrite: args.overwrite,
+                dryRun: args.dryRun,
+            });
+        }, (result) => {
+            const restart = args.scope === "desktop" && !result.dryRun;
+            return okResponse(formatWriteResult(result, `add server "${args.name}" to`, restart), { result, restartRequired: restart });
+        });
+    });
+    // ------------------------------------------------------------------
+    // mcp_update_server
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_update_server", {
+        title: "Patch an MCP server entry",
+        description: "Update one or more fields of an existing MCP server entry. Only provided fields are changed.",
+        inputSchema: {
+            scope: WritableScopeSchema,
+            name: z.string().min(1),
+            command: z.string().optional(),
+            args: z.array(z.string()).optional(),
+            env: z.record(z.string()).optional(),
+            cwd: z.string().optional(),
+            url: z.string().url().optional(),
+            headers: z.record(z.string()).optional(),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => {
+        const patch = {};
+        if (args.command !== undefined)
+            patch.command = args.command;
+        if (args.args !== undefined)
+            patch.args = args.args;
+        if (args.env !== undefined)
+            patch.env = args.env;
+        if (args.cwd !== undefined)
+            patch.cwd = args.cwd;
+        if (args.url !== undefined)
+            patch.url = args.url;
+        if (args.headers !== undefined)
+            patch.headers = args.headers;
+        return updateServer({
+            scope: args.scope,
+            name: args.name,
+            patch: patch,
+            projectPath: args.projectPath,
+            dryRun: args.dryRun,
+        });
+    }, (result) => {
+        const restart = args.scope === "desktop" && !result.dryRun;
+        return okResponse(formatWriteResult(result, `update server "${args.name}" in`, restart), { result, restartRequired: restart });
+    }));
+    // ------------------------------------------------------------------
+    // mcp_remove_server
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_remove_server", {
+        title: "Remove an MCP server",
+        description: "Delete an MCP server entry by name from a given scope.",
+        inputSchema: {
+            scope: WritableScopeSchema,
+            name: z.string().min(1),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => removeServer({
+        scope: args.scope,
+        name: args.name,
+        projectPath: args.projectPath,
+        dryRun: args.dryRun,
+    }), (result) => {
+        const restart = args.scope === "desktop" && !result.dryRun;
+        return okResponse(formatWriteResult(result, `remove server "${args.name}" from`, restart), { result, restartRequired: restart });
+    }));
+    // ------------------------------------------------------------------
+    // mcp_set_disabled
+    // ------------------------------------------------------------------
+    server.registerTool("mcp_set_disabled", {
+        title: "Enable or disable an MCP server",
+        description: "Toggle an MCP server on/off by setting its `disabled` flag. File is preserved.",
+        inputSchema: {
+            scope: WritableScopeSchema,
+            name: z.string().min(1),
+            disabled: z.boolean(),
+            ...ProjectPathField,
+            ...DryRunField,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => handle(() => setServerDisabled({
+        scope: args.scope,
+        name: args.name,
+        disabled: args.disabled,
+        projectPath: args.projectPath,
+        dryRun: args.dryRun,
+    }), (result) => {
+        const restart = args.scope === "desktop" && !result.dryRun;
+        const verb = args.disabled ? "disable" : "enable";
+        return okResponse(formatWriteResult(result, `${verb} server "${args.name}" in`, restart), { result, restartRequired: restart });
+    }));
+}
+//# sourceMappingURL=mcp.js.map