feat: mcp tool (#487)

Author: mathio

.changeset/rude-crabs-remember.md

@@ -0,0 +1,5 @@
+---
+"lingo.dev": minor
+---
+
+add mcp command

packages/cli/package.json

@@ -48,6 +48,7 @@
     "@inquirer/prompts": "^7.2.3",
     "@lingo.dev/_sdk": "workspace:*",
     "@lingo.dev/_spec": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.5.0",
     "@paralleldrive/cuid2": "^2.2.2",
     "chalk": "^5.4.1",
     "cors": "^2.8.5",

packages/cli/src/cli/cmd/mcp.ts

@@ -0,0 +1,65 @@
+import { Command } from "interactive-commander";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import Z from "zod";
+import { ReplexicaEngine } from "@lingo.dev/_sdk";
+import { getSettings } from "../utils/settings";
+import { createAuthenticator } from "../utils/auth";
+
+export default new Command()
+  .command("mcp")
+  .description("Use Lingo.dev model context provider with your AI agent")
+  .helpOption("-h, --help", "Show help")
+  .action(async (_, program) => {
+    const apiKey = program.args[0];
+    const settings = getSettings(apiKey);
+
+    if (!settings.auth.apiKey) {
+      console.error("No API key provided");
+      return;
+    }
+
+    const authenticator = createAuthenticator({
+      apiUrl: settings.auth.apiUrl,
+      apiKey: settings.auth.apiKey!,
+    });
+    const auth = await authenticator.whoami();
+
+    if (!auth) {
+      console.error("Not authenticated");
+      return;
+    } else {
+      console.log(`Authenticated as ${auth.email}`);
+    }
+
+    const replexicaEngine = new ReplexicaEngine({
+      apiKey: settings.auth.apiKey,
+      apiUrl: settings.auth.apiUrl,
+    });
+
+    const server = new McpServer({
+      name: "Lingo.dev",
+      version: "1.0.0",
+    });
+
+    server.tool(
+      "translate",
+      "Detect language and translate text with Lingo.dev.",
+      {
+        text: Z.string(),
+        targetLocale: Z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/),
+      },
+      async ({ text, targetLocale }) => {
+        const sourceLocale = await replexicaEngine.recognizeLocale(text);
+        const data = await replexicaEngine.localizeText(text, {
+          sourceLocale,
+          targetLocale,
+        });
+        return { content: [{ type: "text", text: data }] };
+      },
+    );
+
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.log("Lingo.dev MCP Server running on stdio");
+  });

packages/cli/src/cli/index.ts

@@ -11,6 +11,7 @@ import configCmd from "./cmd/show";
 import i18nCmd from "./cmd/i18n";
 import lockfileCmd from "./cmd/lockfile";
 import cleanupCmd from "./cmd/cleanup";
+import mcpCmd from "./cmd/mcp";
 
 import packageJson from "../../package.json";
 
@@ -40,6 +41,7 @@ Website: https://lingo.dev
   .addCommand(configCmd)
   .addCommand(lockfileCmd)
   .addCommand(cleanupCmd)
+  .addCommand(mcpCmd)
   .exitOverride((err) => {
     // Exit with code 0 when help or version is displayed
     if (err.code === "commander.helpDisplayed" || err.code === "commander.version" || err.code === "commander.help") {