cheap-llm-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,115 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getUsageSummary, resetUsage } from "./accounting.js";
+import { callChatCompletion } from "./chat.js";
+import { envFlag } from "./env.js";
+import { allProviders, providerSetupStatus } from "./providers.js";
+import { maxPromptChars } from "./safety.js";
+export const SERVER_NAME = "cheap-llm-mcp";
+export const SERVER_VERSION = "0.1.0";
+export function createServer(source = process.env) {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION
+    });
+    server.registerTool("list_simple_model_providers", {
+        title: "List configured simple LLM providers",
+        description: "Show configured low-cost OpenAI-compatible model providers without exposing API keys.",
+        inputSchema: {}
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(providerSetupStatus(source), null, 2)
+            }
+        ]
+    }));
+    server.registerTool("ask_simple_model", {
+        title: "Ask a cheap simple-task LLM",
+        description: "Delegate simple, low-risk tasks to a configured cheap OpenAI-compatible model. Use for summarizing, rewriting, translating, classification, extraction, short regex, or small code snippets. Treat the result as a draft: the host AI must lightly review it against the original task before using it, without sending extra context or asking for a second review unless necessary. Do not use for architecture decisions, risky edits, security-sensitive decisions, or private workspace context unless the user explicitly permits sending that context to the provider.",
+        inputSchema: {
+            prompt: z.string().min(1).describe("The exact self-contained task to send to the provider."),
+            provider: z.string().optional().describe("Provider name, for example deepseek, qwen, or mimo."),
+            model: z.string().optional().describe("Override the provider default model."),
+            system: z.string().optional().describe("Optional system instruction."),
+            approvedForExternalApi: z
+                .boolean()
+                .optional()
+                .describe("Must be true only after confirming the prompt is safe to send to the third-party model API."),
+            dataClassification: z
+                .enum(["public", "internal", "private", "sensitive"])
+                .optional()
+                .describe("Classification of the prompt content. sensitive content is always rejected."),
+            temperature: z.number().min(0).max(2).optional().describe("Sampling temperature. Defaults to 0.2."),
+            maxTokens: z.number().int().positive().max(8192).optional().describe("Maximum output tokens. Defaults to 800."),
+            responseFormat: z.enum(["text", "json_object"]).optional().describe("Request text or JSON object output."),
+            includeUsage: z.boolean().optional().describe("Append provider usage metadata when available."),
+            requestTimeoutMs: z.number().int().positive().max(300000).optional().describe("Abort the provider request after this many milliseconds."),
+            extraBody: z.record(z.unknown()).optional().describe("Provider-specific JSON body overrides.")
+        }
+    }, async (input) => ({
+        content: [
+            {
+                type: "text",
+                text: await callChatCompletion(input, source)
+            }
+        ]
+    }));
+    server.registerTool("get_token_savings", {
+        title: "Get cheap LLM token savings",
+        description: "Show how many provider-reported tokens have been routed to cheap models in this MCP server session. Treat this as actual cheap-model token usage plus a rough premium-token volume avoided estimate.",
+        inputSchema: {
+            reset: z.boolean().optional().describe("Reset in-memory counters after returning the current summary.")
+        }
+    }, async (input) => {
+        const summary = getUsageSummary();
+        if (input.reset) {
+            resetUsage();
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(summary, null, 2)
+                }
+            ]
+        };
+    });
+    server.registerTool("check_simple_model_setup", {
+        title: "Check cheap LLM MCP setup",
+        description: "Validate local provider configuration without making a model request. Shows missing API keys, endpoint URLs, HTTPS status, and safety limits.",
+        inputSchema: {}
+    }, async () => {
+        const providers = providerSetupStatus(source);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: providers.length > 0 && providers.every((provider) => provider.hasApiKey && provider.https),
+                        safety: {
+                            maxPromptChars: maxPromptChars(source),
+                            sensitiveDataRejected: true,
+                            secretPatternScan: true,
+                            requiresApprovedForExternalApi: true,
+                            chineseDefault: envFlag("SIMPLE_LLM_CHINESE_DEFAULT", true, source),
+                            stabilityDefault: envFlag("SIMPLE_LLM_STABILITY_DEFAULT", true, source),
+                            hostReviewRequired: true,
+                            allowHttp: envFlag("SIMPLE_LLM_ALLOW_HTTP", false, source)
+                        },
+                        providers
+                    }, null, 2)
+                }
+            ]
+        };
+    });
+    return server;
+}
+export async function startStdioServer(source = process.env) {
+    allProviders(source);
+    const server = createServer(source);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# 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/setup.d.ts

@@ -0,0 +1,22 @@
+type Client = "claude" | "codex";
+export type ProviderAnswers = {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    chatPath?: string;
+};
+export type SetupOptions = ProviderAnswers & {
+    clients: Client[];
+    execute?: boolean;
+};
+export declare function buildClaudeCommand(answer: ProviderAnswers): string[];
+export declare function buildCodexCommand(answer: ProviderAnswers): string[];
+export declare function shellQuote(value: string): string;
+export declare function commandToString(command: string[]): string;
+export declare function codexTomlSnippet(answer: ProviderAnswers): string;
+export declare function claudeJsonSnippet(answer: ProviderAnswers): string;
+export declare function collectSetupOptions(): Promise<SetupOptions>;
+export declare function commandsForSetup(options: SetupOptions): string[][];
+export declare function runSetup(options?: SetupOptions): Promise<number>;
+export declare function printConfig(): void;
+export {};

package/dist/setup.js

@@ -0,0 +1,133 @@
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+const PACKAGE_SPEC = "cheap-llm-mcp@latest";
+const SERVER_NAME = "cheap-llm";
+function envPairsForProvider(answer) {
+    const env = {
+        CHEAP_LLM_BASE_URL: answer.baseUrl ?? "https://api.deepseek.com",
+        CHEAP_LLM_MODEL: answer.model ?? "deepseek-chat",
+        CHEAP_LLM_CHAT_PATH: answer.chatPath ?? "/chat/completions",
+        SIMPLE_LLM_DEFAULT_PROVIDER: "cheap",
+        SIMPLE_LLM_CHINESE_DEFAULT: "true",
+        SIMPLE_LLM_STABILITY_DEFAULT: "true",
+        SIMPLE_LLM_MAX_PROMPT_CHARS: "12000",
+        SIMPLE_LLM_TIMEOUT_MS: "60000"
+    };
+    if (answer.apiKey) {
+        env.CHEAP_LLM_API_KEY = answer.apiKey;
+    }
+    return Object.fromEntries(Object.entries(env).filter(([, value]) => value.length > 0));
+}
+export function buildClaudeCommand(answer) {
+    const envArgs = Object.entries(envPairsForProvider(answer)).flatMap(([key, value]) => ["--env", `${key}=${value}`]);
+    return ["claude", "mcp", "add", "--transport", "stdio", "--scope", "user", ...envArgs, SERVER_NAME, "--", "npx", "-y", PACKAGE_SPEC];
+}
+export function buildCodexCommand(answer) {
+    const envArgs = Object.entries(envPairsForProvider(answer)).flatMap(([key, value]) => ["--env", `${key}=${value}`]);
+    return ["codex", "mcp", "add", SERVER_NAME, ...envArgs, "--", "npx", "-y", PACKAGE_SPEC];
+}
+export function shellQuote(value) {
+    return /\s|["']/.test(value) ? JSON.stringify(value) : value;
+}
+export function commandToString(command) {
+    return command.map(shellQuote).join(" ");
+}
+export function codexTomlSnippet(answer) {
+    const envLines = Object.entries(envPairsForProvider(answer))
+        .map(([key, value]) => `${key} = ${JSON.stringify(value)}`)
+        .join("\n");
+    return `[mcp_servers.${SERVER_NAME}]
+command = "npx"
+args = ["-y", "${PACKAGE_SPEC}"]
+
+[mcp_servers.${SERVER_NAME}.env]
+${envLines}
+`;
+}
+export function claudeJsonSnippet(answer) {
+    return JSON.stringify({
+        type: "stdio",
+        command: "npx",
+        args: ["-y", PACKAGE_SPEC],
+        env: envPairsForProvider(answer)
+    }, null, 2);
+}
+async function choose(prompt, choices, defaultIndex = 0) {
+    const rl = createInterface({ input, output });
+    try {
+        output.write(`${prompt}\n`);
+        choices.forEach((choice, index) => output.write(`  ${index + 1}. ${choice}${index === defaultIndex ? " (default)" : ""}\n`));
+        const raw = await rl.question("> ");
+        const index = raw.trim() ? Number(raw.trim()) - 1 : defaultIndex;
+        return choices[index] ?? choices[defaultIndex];
+    }
+    finally {
+        rl.close();
+    }
+}
+async function ask(prompt, defaultValue = "") {
+    const rl = createInterface({ input, output });
+    try {
+        const suffix = defaultValue ? ` (${defaultValue})` : "";
+        const answer = await rl.question(`${prompt}${suffix}: `);
+        return answer.trim() || defaultValue;
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function collectSetupOptions() {
+    const clientChoice = await choose("Which client should be configured?", ["Claude Code", "Codex", "Both"], 2);
+    const baseUrl = await ask("OpenAI-compatible base URL", "https://api.deepseek.com");
+    const model = await ask("Model id", "deepseek-chat");
+    const chatPath = await ask("Chat completions path", "/chat/completions");
+    const apiKey = await ask("API key (leave blank if you will fill it manually in the client config)");
+    const execute = (await choose("Execute these install commands now?", ["Yes", "No"], 0)) === "Yes";
+    return {
+        clients: clientChoice === "Both" ? ["claude", "codex"] : clientChoice === "Claude Code" ? ["claude"] : ["codex"],
+        apiKey: apiKey || undefined,
+        baseUrl,
+        model,
+        chatPath,
+        execute
+    };
+}
+export function commandsForSetup(options) {
+    return options.clients.map((client) => (client === "claude" ? buildClaudeCommand(options) : buildCodexCommand(options)));
+}
+export async function runSetup(options) {
+    const selected = options ?? (await collectSetupOptions());
+    const commands = commandsForSetup(selected);
+    output.write("\nCommands:\n");
+    commands.forEach((command) => output.write(`  ${commandToString(command)}\n`));
+    if (!selected.execute) {
+        output.write("\nSkipped execution. Copy a command above, or run setup again and choose execution.\n");
+        output.write("\nManual Codex fallback:\n");
+        output.write(codexTomlSnippet(selected));
+        return 0;
+    }
+    for (const command of commands) {
+        output.write(`\nRunning: ${commandToString(command)}\n`);
+        const result = process.platform === "win32"
+            ? spawnSync("cmd.exe", ["/d", "/s", "/c", commandToString(command)], { stdio: "inherit" })
+            : spawnSync(command[0], command.slice(1), { stdio: "inherit" });
+        if (result.status !== 0) {
+            output.write("\nCommand failed. Manual Codex fallback:\n");
+            output.write(codexTomlSnippet(selected));
+            return result.status ?? 1;
+        }
+    }
+    output.write("\nDone. Restart Claude Code or Codex, then check /mcp or run codex mcp list.\n");
+    return 0;
+}
+export function printConfig() {
+    const answer = {};
+    output.write("Claude Code:\n");
+    output.write(`${commandToString(buildClaudeCommand(answer))}\n\n`);
+    output.write("Codex:\n");
+    output.write(`${commandToString(buildCodexCommand(answer))}\n\n`);
+    output.write("Codex config.toml fallback:\n");
+    output.write(codexTomlSnippet(answer));
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+export type DataClassification = "public" | "internal" | "private" | "sensitive";
+export type ProviderConfig = {
+    name: string;
+    baseUrl: string;
+    chatPath?: string;
+    apiKey?: string;
+    apiKeyEnv?: string;
+    model: string;
+    headers?: Record<string, string>;
+    defaultBody?: Record<string, unknown>;
+    timeoutMs?: number;
+};
+export type ChatCompletionResponse = {
+    choices?: Array<{
+        message?: {
+            content?: string | null;
+            reasoning_content?: string | null;
+        };
+        finish_reason?: string;
+    }>;
+    usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    };
+    model?: string;
+};
+export type ChatMessage = {
+    role: "system" | "user";
+    content: string;
+};
+export type AskSimpleModelInput = {
+    provider?: string;
+    model?: string;
+    system?: string;
+    prompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: "text" | "json_object";
+    includeUsage?: boolean;
+    extraBody?: Record<string, unknown>;
+    requestTimeoutMs?: number;
+    approvedForExternalApi?: boolean;
+    dataClassification?: DataClassification;
+};

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,63 @@
+{
+  "name": "cheap-llm-mcp",
+  "version": "0.1.0",
+  "description": "Save premium-model tokens by routing simple tasks to cheap OpenAI-compatible LLMs.",
+  "type": "module",
+  "bin": {
+    "cheap-llm-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test test/*.test.ts",
+    "ci": "npm run typecheck && npm run build && npm test",
+    "prepublishOnly": "npm run ci",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "token-saver",
+    "llm-router",
+    "deepseek",
+    "mimo",
+    "qwen",
+    "openai-compatible"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stBlackCat/cheap-llm-mcp.git"
+  },
+  "homepage": "https://github.com/stBlackCat/cheap-llm-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/stBlackCat/cheap-llm-mcp/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    ".env.example",
+    "codex-config.example.toml"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}