@better-i18n/mcp 0.12.0 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/tools/getTranslations.d.ts +6 -1
- package/dist/tools/getTranslations.d.ts.map +1 -1
- package/dist/tools/getTranslations.js +14 -6
- package/dist/tools/getTranslations.js.map +1 -1
- package/dist/tools/updateKeys.d.ts +4 -2
- package/dist/tools/updateKeys.d.ts.map +1 -1
- package/dist/tools/updateKeys.js +10 -29
- package/dist/tools/updateKeys.js.map +1 -1
- package/package.json +2 -2
|
@@ -13,7 +13,12 @@
|
|
|
13
13
|
* - status: Filter by translation status ("missing", "draft", "approved", "all")
|
|
14
14
|
* - namespaces: Filter by namespace(s)
|
|
15
15
|
* - keys: Fetch specific keys by exact name
|
|
16
|
-
* - limit: Max keys to return (default
|
|
16
|
+
* - limit: Max keys to return (1–200, default 100)
|
|
17
|
+
*
|
|
18
|
+
* RESPONSE INCLUDES PAGINATION METADATA:
|
|
19
|
+
* - returned: number of keys in this response
|
|
20
|
+
* - total: total keys in DB matching your filters (before status filter)
|
|
21
|
+
* - hasMore: true when total > limit — use narrower filters to get specific keys
|
|
17
22
|
*
|
|
18
23
|
* EXAMPLES:
|
|
19
24
|
* - Find "login" in source: { project: "org/project", search: "login" }
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"getTranslations.d.ts","sourceRoot":"","sources":["../../src/tools/getTranslations.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"getTranslations.d.ts","sourceRoot":"","sources":["../../src/tools/getTranslations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAW9C,eAAO,MAAM,eAAe,EAAE,IAyF7B,CAAC"}
|
|
@@ -13,7 +13,12 @@
|
|
|
13
13
|
* - status: Filter by translation status ("missing", "draft", "approved", "all")
|
|
14
14
|
* - namespaces: Filter by namespace(s)
|
|
15
15
|
* - keys: Fetch specific keys by exact name
|
|
16
|
-
* - limit: Max keys to return (default
|
|
16
|
+
* - limit: Max keys to return (1–200, default 100)
|
|
17
|
+
*
|
|
18
|
+
* RESPONSE INCLUDES PAGINATION METADATA:
|
|
19
|
+
* - returned: number of keys in this response
|
|
20
|
+
* - total: total keys in DB matching your filters (before status filter)
|
|
21
|
+
* - hasMore: true when total > limit — use narrower filters to get specific keys
|
|
17
22
|
*
|
|
18
23
|
* EXAMPLES:
|
|
19
24
|
* - Find "login" in source: { project: "org/project", search: "login" }
|
|
@@ -31,7 +36,7 @@ const inputSchema = projectSchema.extend({
|
|
|
31
36
|
namespaces: z.array(z.string()).optional(),
|
|
32
37
|
keys: z.array(z.string()).optional(),
|
|
33
38
|
status: z.enum(["missing", "draft", "approved", "all"]).optional(),
|
|
34
|
-
limit: z.number().min(
|
|
39
|
+
limit: z.number().min(1).max(200).optional(),
|
|
35
40
|
});
|
|
36
41
|
export const getTranslations = {
|
|
37
42
|
definition: {
|
|
@@ -45,11 +50,14 @@ SEARCH + FILTER:
|
|
|
45
50
|
- search: Text to search for (in source text or specified languages)
|
|
46
51
|
- languages: Languages to search in AND return translations for
|
|
47
52
|
- status: Filter by translation status ("missing", "draft", "approved", "all")
|
|
48
|
-
|
|
49
|
-
FILTER OPTIONS:
|
|
50
53
|
- namespaces: Filter by namespace(s)
|
|
51
54
|
- keys: Fetch specific keys by exact name
|
|
52
|
-
- limit: Max keys
|
|
55
|
+
- limit: Max keys (1–200, default 100)
|
|
56
|
+
|
|
57
|
+
RESPONSE METADATA:
|
|
58
|
+
- returned: keys in this response (after all filters)
|
|
59
|
+
- total: DB count before in-memory status filter
|
|
60
|
+
- hasMore: true when total > limit — narrow your filters to get specific results
|
|
53
61
|
|
|
54
62
|
EXAMPLES:
|
|
55
63
|
- Find "login" in source: { search: "login" }
|
|
@@ -90,7 +98,7 @@ Response includes namespaceDetails: a map of namespace metadata (name, keyCount,
|
|
|
90
98
|
},
|
|
91
99
|
limit: {
|
|
92
100
|
type: "number",
|
|
93
|
-
description: "
|
|
101
|
+
description: "Max keys to return (1–200, default 100). Check 'returned', 'total', 'hasMore' in response to understand result size. Use narrower filters to get specific keys.",
|
|
94
102
|
},
|
|
95
103
|
},
|
|
96
104
|
required: ["project"],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"getTranslations.js","sourceRoot":"","sources":["../../src/tools/getTranslations.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"getTranslations.js","sourceRoot":"","sources":["../../src/tools/getTranslations.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,8 +2,10 @@
|
|
|
2
2
|
* updateKeys MCP Tool
|
|
3
3
|
*
|
|
4
4
|
* Updates source text and/or target translations for one or more keys.
|
|
5
|
-
* Uses
|
|
6
|
-
*
|
|
5
|
+
* Uses UUID-based schema matching the API: t=[{id, l, t, s, st}].
|
|
6
|
+
*
|
|
7
|
+
* IMPORTANT: id (UUID) is required — get it from getAllTranslations or listKeys response.
|
|
8
|
+
* The old k/ns/nc format has been removed. Use id exclusively.
|
|
7
9
|
*/
|
|
8
10
|
import type { Tool } from "../types/index.js";
|
|
9
11
|
export declare const updateKeys: Tool;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"updateKeys.d.ts","sourceRoot":"","sources":["../../src/tools/updateKeys.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"updateKeys.d.ts","sourceRoot":"","sources":["../../src/tools/updateKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAc9C,eAAO,MAAM,UAAU,EAAE,IA2CxB,CAAC"}
|
package/dist/tools/updateKeys.js
CHANGED
|
@@ -2,33 +2,26 @@
|
|
|
2
2
|
* updateKeys MCP Tool
|
|
3
3
|
*
|
|
4
4
|
* Updates source text and/or target translations for one or more keys.
|
|
5
|
-
* Uses
|
|
6
|
-
*
|
|
5
|
+
* Uses UUID-based schema matching the API: t=[{id, l, t, s, st}].
|
|
6
|
+
*
|
|
7
|
+
* IMPORTANT: id (UUID) is required — get it from getAllTranslations or listKeys response.
|
|
8
|
+
* The old k/ns/nc format has been removed. Use id exclusively.
|
|
7
9
|
*/
|
|
8
10
|
import { z } from "zod";
|
|
9
11
|
import { executeTool, projectInputProperty, projectSchema, success, } from "../base-tool.js";
|
|
10
|
-
const namespaceContextSchema = z.object({
|
|
11
|
-
description: z.string().optional(),
|
|
12
|
-
team: z.string().optional(),
|
|
13
|
-
domain: z.string().optional(),
|
|
14
|
-
aiPrompt: z.string().optional(),
|
|
15
|
-
tags: z.array(z.string()).optional(),
|
|
16
|
-
}).optional();
|
|
17
12
|
const inputSchema = projectSchema.extend({
|
|
18
13
|
t: z.array(z.object({
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
l: z.string().describe("Language code (e.g., 'en', 'tr', 'de')"),
|
|
14
|
+
id: z.string().describe("Translation key UUID — get from getAllTranslations or listKeys response (id field)"),
|
|
15
|
+
l: z.string().describe("Language code (e.g., 'tr', 'de')"),
|
|
22
16
|
t: z.string().describe("Translation text"),
|
|
23
17
|
s: z.boolean().optional().describe("true if updating source language text"),
|
|
24
18
|
st: z.string().optional().describe("Translation status (e.g., 'approved')"),
|
|
25
|
-
nc: namespaceContextSchema,
|
|
26
19
|
})).min(1),
|
|
27
20
|
});
|
|
28
21
|
export const updateKeys = {
|
|
29
22
|
definition: {
|
|
30
23
|
name: "updateKeys",
|
|
31
|
-
description: "Update translations. Each entry updates ONE language for ONE key. Set s=true to update the source text.",
|
|
24
|
+
description: "Update translations for existing keys. REQUIRED: Get key UUIDs first via getAllTranslations or listKeys (id field). Each entry updates ONE language for ONE key. Set s=true to update the source text.",
|
|
32
25
|
inputSchema: {
|
|
33
26
|
type: "object",
|
|
34
27
|
properties: {
|
|
@@ -39,25 +32,13 @@ export const updateKeys = {
|
|
|
39
32
|
items: {
|
|
40
33
|
type: "object",
|
|
41
34
|
properties: {
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
l: { type: "string", description: "Language code (e.g., 'en', 'tr', 'de')" },
|
|
35
|
+
id: { type: "string", description: "Translation key UUID (required). Get from getAllTranslations or listKeys response." },
|
|
36
|
+
l: { type: "string", description: "Language code (e.g., 'tr', 'de')" },
|
|
45
37
|
t: { type: "string", description: "Translation text" },
|
|
46
38
|
s: { type: "boolean", description: "true if updating source language text" },
|
|
47
39
|
st: { type: "string", description: "Translation status (e.g., 'approved')" },
|
|
48
|
-
nc: {
|
|
49
|
-
type: "object",
|
|
50
|
-
description: "Optional context for the namespace (description, team, domain, aiPrompt, tags). Applied once per namespace.",
|
|
51
|
-
properties: {
|
|
52
|
-
description: { type: "string", description: "What this namespace is about" },
|
|
53
|
-
team: { type: "string", description: "Team owning this namespace" },
|
|
54
|
-
domain: { type: "string", description: "Business domain (e.g., 'auth', 'billing')" },
|
|
55
|
-
aiPrompt: { type: "string", description: "Custom AI prompt for translations in this namespace" },
|
|
56
|
-
tags: { type: "array", items: { type: "string" }, description: "Tags for categorization" },
|
|
57
|
-
},
|
|
58
|
-
},
|
|
59
40
|
},
|
|
60
|
-
required: ["
|
|
41
|
+
required: ["id", "l", "t"],
|
|
61
42
|
},
|
|
62
43
|
},
|
|
63
44
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"updateKeys.js","sourceRoot":"","sources":["../../src/tools/updateKeys.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"updateKeys.js","sourceRoot":"","sources":["../../src/tools/updateKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,OAAO,GACR,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC;IACvC,CAAC,EAAE,CAAC,CAAC,KAAK,CACR,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;QAC7G,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC1D,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC1C,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC3E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KAC5E,CAAC,CACH,CAAC,GAAG,CAAC,CAAC,CAAC;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,wMAAwM;QAC1M,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,oBAAoB;gBACvB,CAAC,EAAE;oBACD,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,4EAA4E;oBACzF,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oFAAoF,EAAE;4BACzH,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;4BACtE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;4BACtD,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE;4BAC5E,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;yBAC7E;wBACD,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;qBAC3B;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC;SAC3B;KACF;IAED,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CACxB,WAAW,CACT,IAAI,EACJ,WAAW,EACX,KAAK,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;YAChD,OAAO,EAAE,WAAW;YACpB,WAAW;YACX,CAAC,EAAE,KAAK,CAAC,CAAC;SACX,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CACF;CACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@better-i18n/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"description": "MCP server for Better i18n translation management - AI-powered translation workflow for Cursor, Claude, and other AI assistants",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"prepublishOnly": "npm run clean && npm run build && chmod +x ./dist/index.js ./dist/http.js"
|
|
51
51
|
},
|
|
52
52
|
"dependencies": {
|
|
53
|
-
"@better-i18n/mcp-types": "^0.
|
|
53
|
+
"@better-i18n/mcp-types": "^0.9.1",
|
|
54
54
|
"@modelcontextprotocol/sdk": "^1.25.3",
|
|
55
55
|
"@trpc/client": "^11.0.0",
|
|
56
56
|
"zod": "^3.25.1"
|