@udondan/duolingo 1.0.0

package/dist/tools/shop.js

@@ -0,0 +1,125 @@
+/**
+ * Utility Duolingo MCP tools.
+ *
+ * Tools: get_language_from_abbr, get_abbreviation_of
+ */
+import { z } from 'zod';
+import { getClient } from '../client/duolingo.js';
+import { handleError, UsernameFieldSchema } from './helpers.js';
+export function registerShopTools(server) {
+    // -------------------------------------------------------------------------
+    // Get Language from Abbreviation
+    // -------------------------------------------------------------------------
+    server.registerTool('duolingo_get_language_from_abbr', {
+        title: 'Get Duolingo Language Name from Abbreviation',
+        description: 'Convert a language abbreviation to its full name. ' +
+            'Only works for languages the given user is currently learning.',
+        inputSchema: {
+            language_abbr: z
+                .string()
+                .min(2)
+                .max(5)
+                .describe("Language abbreviation to look up (e.g. 'fr', 'es', 'de')."),
+            username: UsernameFieldSchema,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ language_abbr, username }) => {
+        try {
+            const client = getClient();
+            let userId;
+            if (!username) {
+                const userData = await client.getUserData();
+                userId = userData.id;
+            }
+            else {
+                userId = await client.getUserIdByUsername(username);
+            }
+            const v2 = await client.getUserDataV2(userId);
+            const course = v2.courses.find((c) => c.subject === 'language' &&
+                (c.learningLanguage === language_abbr || c.topic === language_abbr));
+            if (!course) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No language found for abbreviation '${language_abbr}'. ` +
+                                'Make sure the user is learning this language.',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: course.title ?? course.learningLanguage ?? language_abbr,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: 'text', text: handleError(err) }] };
+        }
+    });
+    // -------------------------------------------------------------------------
+    // Get Abbreviation Of
+    // -------------------------------------------------------------------------
+    server.registerTool('duolingo_get_abbreviation_of', {
+        title: 'Get Duolingo Language Abbreviation',
+        description: 'Convert a full language name to its abbreviation. ' +
+            'Only works for languages the given user is currently learning.',
+        inputSchema: {
+            language_name: z
+                .string()
+                .min(1)
+                .describe("Full language name to look up (e.g. 'French', 'Spanish')."),
+            username: UsernameFieldSchema,
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ language_name, username }) => {
+        try {
+            const client = getClient();
+            let userId;
+            if (!username) {
+                const userData = await client.getUserData();
+                userId = userData.id;
+            }
+            else {
+                userId = await client.getUserIdByUsername(username);
+            }
+            const v2 = await client.getUserDataV2(userId);
+            const course = v2.courses.find((c) => c.subject === 'language' &&
+                (c.title ?? '').toLowerCase() === language_name.toLowerCase());
+            if (!course) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No abbreviation found for language '${language_name}'. ` +
+                                'Make sure the user is learning this language.',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    { type: 'text', text: course.learningLanguage ?? course.topic },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: 'text', text: handleError(err) }] };
+        }
+    });
+}
+//# sourceMappingURL=shop.js.map

package/dist/tools/shop.js.map

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

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@udondan/duolingo",
+  "version": "1.0.0",
+  "description": "Duolingo API client library and MCP server",
+  "author": {
+    "name": "Daniel Schroeder",
+    "url": "https://www.udondan.com/"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/udondan"
+    }
+  ],
+  "homepage": "https://github.com/udondan/duolingo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/udondan/duolingo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/udondan/duolingo/issues"
+  },
+  "keywords": [
+    "duolingo",
+    "api",
+    "mcp"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "duolingo-mcp": "dist/server.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "dist/**/*.js.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsx src/server.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\""
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "axios": "^1.7.9",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@vitest/coverage-v8": "^3.1.1",
+    "axios-mock-adapter": "^2.1.0",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}