@better-i18n/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,158 @@
+# @better-i18n/mcp-server
+
+MCP (Model Context Protocol) server for [Better i18n](https://better-i18n.com) translation management. Enables AI assistants like Claude (via Cursor) to manage your translations directly from your IDE.
+
+## Features
+
+- 🤖 **AI-Powered Translation Management** - Let AI handle your translations
+- 📝 **Create Translation Keys** - Add new keys with source text and translations
+- 🔄 **Bulk Operations** - Create/update multiple keys at once
+- 🔍 **Smart Search** - Find keys by name, namespace, or missing translations
+- 🌍 **Multi-language Support** - Manage all your target languages
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @better-i18n/mcp-server
+```
+
+### With npx
+
+You can also run it directly without installing:
+
+```bash
+npx @better-i18n/mcp-server
+```
+
+## Setup
+
+### 1. Get Your API Key
+
+1. Go to [better-i18n.com/settings/api-keys](https://better-i18n.com/settings/api-keys)
+2. Create a new API key
+3. Copy the key (you won't see it again!)
+
+### 2. Add i18n.config.ts to Your Project
+
+Create an `i18n.config.ts` in your project root:
+
+```typescript
+import { createI18n } from "@better-i18n/next"; // or your framework
+
+export const i18n = createI18n({
+  workspaceId: "your-org-slug",    // Your organization slug
+  projectSlug: "your-project",      // Your project slug
+  defaultLocale: "en",
+});
+```
+
+### 3. Configure Your IDE
+
+#### Cursor
+
+Add to your MCP settings (`~/.cursor/mcp.json` or project's `.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "better-i18n": {
+      "command": "npx",
+      "args": ["@better-i18n/mcp-server"],
+      "env": {
+        "BETTER_I18N_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Or with global install:
+
+```json
+{
+  "mcpServers": {
+    "better-i18n": {
+      "command": "better-i18n-mcp",
+      "env": {
+        "BETTER_I18N_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `getProjectInfo`
+Get project information including available namespaces, languages, and key count.
+
+### `listKeys`
+List translation keys with optional filtering:
+- `search` - Search by key name
+- `namespaces` - Filter by namespaces
+- `missingLanguage` - Find keys missing a specific language translation
+
+### `createTranslationKey`
+Create a single translation key with source text and optional translations.
+
+### `bulkCreateKeys`
+Create multiple translation keys with all translations in one request.
+
+```json
+{
+  "keys": [
+    {
+      "key": "nav.home",
+      "namespace": "nav",
+      "sourceText": "Home",
+      "translations": { "tr": "Ana Sayfa", "de": "Startseite" }
+    }
+  ]
+}
+```
+
+### `updateTranslation`
+Update a single translation for a specific language.
+
+### `bulkUpdateTranslations`
+Update translations for multiple keys at once.
+
+## Example Workflow
+
+Ask your AI assistant:
+
+> "Add Turkish translations for all keys in the nav namespace that are missing Turkish"
+
+The AI will:
+1. Use `listKeys` with `missingLanguage: "tr"` and `namespaces: ["nav"]`
+2. Use `bulkUpdateTranslations` to add the Turkish translations
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `BETTER_I18N_API_KEY` | Yes | Your API key from better-i18n.com |
+| `BETTER_I18N_API_URL` | No | API URL (default: https://better-i18n.com) |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/better-i18n/better-i18n.git
+cd packages/mcp-server
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Build
+npm run build
+```
+
+## License
+
+MIT © [Better i18n](https://better-i18n.com)

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * tRPC client for Paris API with API key authentication
+ */
+export interface ClientConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+/**
+ * Create a tRPC client authenticated with API key
+ *
+ * @param config - API URL, API key, and optional organization ID
+ * @returns Configured tRPC client
+ */
+export declare function createParisClient(config: ClientConfig & {
+    organizationId?: string;
+}): import("@trpc/client").TRPCClient<any>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,0CAuBnF"}

package/dist/client.js

@@ -0,0 +1,34 @@
+/**
+ * tRPC client for Paris API with API key authentication
+ */
+import { createTRPCClient, httpBatchLink } from "@trpc/client";
+/**
+ * Create a tRPC client authenticated with API key
+ *
+ * @param config - API URL, API key, and optional organization ID
+ * @returns Configured tRPC client
+ */
+export function createParisClient(config) {
+    // Ensure URL ends with /api/trpc for tRPC endpoint
+    const url = config.apiUrl.endsWith("/api/trpc")
+        ? config.apiUrl
+        : `${config.apiUrl.replace(/\/$/, "")}/api/trpc`;
+    return createTRPCClient({
+        links: [
+            httpBatchLink({
+                url,
+                headers: () => {
+                    const headers = {
+                        // Better Auth expects API key in x-api-key header
+                        "x-api-key": config.apiKey,
+                    };
+                    if (config.organizationId) {
+                        headers["x-organization-id"] = config.organizationId;
+                    }
+                    return headers;
+                },
+            }),
+        ],
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAW/D;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkD;IAClF,mDAAmD;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7C,CAAC,CAAC,MAAM,CAAC,MAAM;QACf,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC;IAEnD,OAAO,gBAAgB,CAAY;QACjC,KAAK,EAAE;YACL,aAAa,CAAC;gBACZ,GAAG;gBACH,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,OAAO,GAA2B;wBACtC,kDAAkD;wBAClD,WAAW,EAAE,MAAM,CAAC,MAAM;qBAC3B,CAAC;oBACF,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;wBAC1B,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC;oBACvD,CAAC;oBACD,OAAO,OAAO,CAAC;gBACjB,CAAC;aACF,CAAC;SACH;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Project context detection
+ *
+ * Automatically detects Better i18n project configuration by searching for
+ * createI18n usage from @better-i18n/next or @better-i18n/core in the workspace.
+ */
+export interface ProjectContext {
+    workspaceId: string;
+    projectSlug: string;
+    defaultLocale: string;
+    cdnBaseUrl?: string;
+}
+/**
+ * Find and parse createI18n configuration in workspace
+ *
+ * Searches for files importing createI18n from @better-i18n packages
+ * and extracts the configuration.
+ *
+ * @param startDir - Starting directory (defaults to process.cwd())
+ * @returns Project context or null if not found
+ */
+export declare function detectProjectContext(startDir?: string): Promise<ProjectContext | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA0BhC"}

package/dist/context.js

@@ -0,0 +1,142 @@
+/**
+ * Project context detection
+ *
+ * Automatically detects Better i18n project configuration by searching for
+ * createI18n usage from @better-i18n/next or @better-i18n/core in the workspace.
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Find and parse createI18n configuration in workspace
+ *
+ * Searches for files importing createI18n from @better-i18n packages
+ * and extracts the configuration.
+ *
+ * @param startDir - Starting directory (defaults to process.cwd())
+ * @returns Project context or null if not found
+ */
+export async function detectProjectContext(startDir = process.cwd()) {
+    try {
+        // Find workspace root
+        const workspaceRoot = findWorkspaceRoot(startDir);
+        console.error(`[better-i18n] Searching for createI18n in ${workspaceRoot}...`);
+        // Search for files with createI18n import
+        const configFile = findCreateI18nFile(workspaceRoot);
+        if (configFile) {
+            console.error(`[better-i18n] Found createI18n in ${configFile}`);
+            const config = parseI18nConfig(configFile);
+            if (config.workspaceId && config.projectSlug) {
+                console.error(`[better-i18n] Detected project: ${config.workspaceId}/${config.projectSlug}`);
+                return config;
+            }
+        }
+    }
+    catch (error) {
+        console.error("[better-i18n] Error detecting project context:", error);
+    }
+    return null;
+}
+/**
+ * Find workspace root by looking for .git or package.json with workspaces
+ */
+function findWorkspaceRoot(startDir) {
+    let currentDir = startDir;
+    const maxDepth = 10;
+    let depth = 0;
+    while (depth < maxDepth) {
+        // Check for .git directory
+        if (existsSync(join(currentDir, ".git"))) {
+            return currentDir;
+        }
+        // Check for workspace root (package.json with workspaces)
+        const pkgPath = join(currentDir, "package.json");
+        if (existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+                if (pkg.workspaces) {
+                    return currentDir;
+                }
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+        depth++;
+    }
+    return startDir;
+}
+/**
+ * Search for files containing createI18n import from @better-i18n packages
+ */
+function findCreateI18nFile(workspaceRoot) {
+    const files = [];
+    // Recursively search for TypeScript/JavaScript files
+    function searchDir(dir, depth = 0) {
+        if (depth > 5)
+            return; // Limit recursion depth
+        try {
+            const entries = readdirSync(dir);
+            for (const entry of entries) {
+                // Skip common directories
+                if (["node_modules", ".git", "dist", "build", ".next"].includes(entry)) {
+                    continue;
+                }
+                const fullPath = join(dir, entry);
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    searchDir(fullPath, depth + 1);
+                }
+                else if (/\.(ts|tsx|js|jsx)$/.test(entry)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            // Ignore permission errors
+        }
+    }
+    searchDir(workspaceRoot);
+    // Search through found files for createI18n import
+    for (const file of files) {
+        try {
+            const content = readFileSync(file, "utf-8");
+            // Check for createI18n import from @better-i18n packages
+            if (/import\s+.*createI18n.*from\s+['"]@better-i18n\/(next|core)['"]/.test(content) &&
+                /createI18n\s*\(/.test(content)) {
+                return file;
+            }
+        }
+        catch {
+            // Ignore read errors
+        }
+    }
+    return null;
+}
+/**
+ * Parse file to extract createI18n configuration
+ *
+ * Uses regex to extract workspaceId, projectSlug, defaultLocale, and cdnBaseUrl
+ * from the createI18n call.
+ */
+function parseI18nConfig(filePath) {
+    const content = readFileSync(filePath, "utf-8");
+    // Extract values using regex
+    const workspaceMatch = content.match(/workspaceId:\s*['"]([^'"]+)['"]/);
+    const projectMatch = content.match(/projectSlug:\s*['"]([^'"]+)['"]/);
+    const localeMatch = content.match(/defaultLocale:\s*['"]([^'"]+)['"]/);
+    const cdnMatch = content.match(/cdnBaseUrl:\s*['"]([^'"]+)['"]/);
+    if (!workspaceMatch || !projectMatch) {
+        throw new Error(`Invalid createI18n config in ${filePath}: missing workspaceId or projectSlug`);
+    }
+    return {
+        workspaceId: workspaceMatch[1],
+        projectSlug: projectMatch[1],
+        defaultLocale: localeMatch?.[1] || "en",
+        cdnBaseUrl: cdnMatch?.[1],
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Better i18n MCP Server
+ *
+ * Model Context Protocol server for Better i18n translation management.
+ * Enables AI assistants (Claude, ChatGPT, etc.) to manage translations
+ * directly from IDEs like Cursor.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * Better i18n MCP Server
+ *
+ * Model Context Protocol server for Better i18n translation management.
+ * Enables AI assistants (Claude, ChatGPT, etc.) to manage translations
+ * directly from IDEs like Cursor.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { createParisClient } from "./client.js";
+import { detectProjectContext } from "./context.js";
+import { bulkCreateKeys } from "./tools/bulkCreateKeys.js";
+import { bulkUpdateTranslations } from "./tools/bulkUpdateTranslations.js";
+import { createTranslationKey } from "./tools/createTranslationKey.js";
+import { getProjectInfo } from "./tools/getProjectInfo.js";
+import { listKeys } from "./tools/listKeys.js";
+import { updateTranslation } from "./tools/updateTranslation.js";
+class ParisI18nServer {
+    server;
+    parisClient;
+    context;
+    constructor() {
+        this.server = new Server({
+            name: "better-i18n",
+            version: "0.1.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Will be initialized in init()
+        this.parisClient = null;
+        this.context = {
+            projectContext: null,
+        };
+    }
+    async init() {
+        // Read configuration from environment
+        const apiUrl = process.env.BETTER_I18N_API_URL || "http://localhost:3000";
+        const apiKey = process.env.BETTER_I18N_API_KEY;
+        const envOrgId = process.env.BETTER_I18N_ORG_ID;
+        if (!apiKey) {
+            console.error("[better-i18n] ERROR: BETTER_I18N_API_KEY environment variable is required");
+            console.error("[better-i18n] Get your API key from: https://better-i18n.com/settings/api-keys");
+            process.exit(1);
+        }
+        // Detect project context from workspace
+        this.context.projectContext = await detectProjectContext();
+        // Resolve organization ID
+        let organizationId = envOrgId;
+        if (!organizationId && this.context.projectContext?.workspaceId) {
+            // Try to lookup org ID from slug using the API
+            try {
+                const authUrl = apiUrl.replace(/\/$/, "") + "/api/auth/organization/list";
+                const response = await fetch(authUrl, {
+                    headers: { "x-api-key": apiKey },
+                });
+                if (response.ok) {
+                    const orgs = await response.json();
+                    const matchingOrg = orgs.find((org) => org.slug === this.context.projectContext?.workspaceId);
+                    if (matchingOrg) {
+                        organizationId = matchingOrg.id;
+                        console.error(`[better-i18n] Resolved org "${matchingOrg.slug}" -> ${organizationId}`);
+                    }
+                }
+            }
+            catch (err) {
+                console.error("[better-i18n] Warning: Could not lookup organization ID:", err);
+            }
+        }
+        // Create Paris API client with organization context
+        this.parisClient = createParisClient({ apiUrl, apiKey, organizationId });
+        if (this.context.projectContext) {
+            console.error(`[better-i18n] Detected project: ${this.context.projectContext.workspaceId}/${this.context.projectContext.projectSlug}`);
+        }
+        else {
+            console.error("[better-i18n] Warning: No i18n.config.ts found. Tools will require explicit projectSlug parameter.");
+        }
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                getProjectInfo.definition,
+                listKeys.definition,
+                createTranslationKey.definition,
+                bulkCreateKeys.definition,
+                updateTranslation.definition,
+                bulkUpdateTranslations.definition,
+            ],
+        }));
+        // Execute tools
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                let result;
+                switch (name) {
+                    case "getProjectInfo":
+                        result = await getProjectInfo.execute(this.parisClient, args, this.context);
+                        break;
+                    case "createTranslationKey":
+                        result = await createTranslationKey.execute(this.parisClient, args, this.context);
+                        break;
+                    case "updateTranslation":
+                        result = await updateTranslation.execute(this.parisClient, args, this.context);
+                        break;
+                    case "listKeys":
+                        result = await listKeys.execute(this.parisClient, args, this.context);
+                        break;
+                    case "bulkCreateKeys":
+                        result = await bulkCreateKeys.execute(this.parisClient, args, this.context);
+                        break;
+                    case "bulkUpdateTranslations":
+                        result = await bulkUpdateTranslations.execute(this.parisClient, args, this.context);
+                        break;
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+                return result;
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error executing ${name}: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("[better-i18n] MCP Server running on stdio");
+    }
+}
+// Start the server
+const server = new ParisI18nServer();
+server.init().then(() => server.run()).catch((error) => {
+    console.error("[better-i18n] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/bulkCreateKeys.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bulkCreateKeys MCP Tool
+ *
+ * Creates multiple translation keys with all translations in a single request.
+ * Perfect for adding entire components or pages worth of translations at once.
+ */
+import type { Tool } from "../types/index.js";
+export declare const bulkCreateKeys: Tool;
+//# sourceMappingURL=bulkCreateKeys.d.ts.map

package/dist/tools/bulkCreateKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkCreateKeys.d.ts","sourceRoot":"","sources":["../../src/tools/bulkCreateKeys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAY9C,eAAO,MAAM,cAAc,EAAE,IA0G5B,CAAC"}