@sonenta/mcp 0.16.0 → 0.16.1
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/README.md +19 -19
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# @
|
|
1
|
+
# @sonenta/mcp
|
|
2
2
|
|
|
3
|
-
MCP server for [
|
|
3
|
+
MCP server for [Sonenta](https://sonenta.com) — wires Claude Desktop and
|
|
4
4
|
other Model Context Protocol clients into your translation project.
|
|
5
5
|
|
|
6
6
|
This npm package **bundles the Python MCP server source** (no PyPI
|
|
@@ -12,13 +12,13 @@ runs the bundled `verbumia_mcp` directly.
|
|
|
12
12
|
```json
|
|
13
13
|
{
|
|
14
14
|
"mcpServers": {
|
|
15
|
-
"
|
|
15
|
+
"sonenta": {
|
|
16
16
|
"command": "npx",
|
|
17
|
-
"args": ["-y", "@
|
|
17
|
+
"args": ["-y", "@sonenta/mcp"],
|
|
18
18
|
"env": {
|
|
19
|
-
"
|
|
20
|
-
"
|
|
21
|
-
"
|
|
19
|
+
"SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
|
|
20
|
+
"SONENTA_PROJECTS": "<project_uuid>",
|
|
21
|
+
"SONENTA_BASE_URL": "https://api.sonenta.com"
|
|
22
22
|
}
|
|
23
23
|
}
|
|
24
24
|
}
|
|
@@ -26,17 +26,17 @@ runs the bundled `verbumia_mcp` directly.
|
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
For **multiple projects** (v0.11+), comma-separate the UUIDs in
|
|
29
|
-
`
|
|
29
|
+
`SONENTA_PROJECTS`. The LLM then has to pass `project_uuid` on every tool
|
|
30
30
|
call:
|
|
31
31
|
|
|
32
32
|
```json
|
|
33
33
|
"env": {
|
|
34
|
-
"
|
|
35
|
-
"
|
|
34
|
+
"SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
|
|
35
|
+
"SONENTA_PROJECTS": "01993a..,01993b..,01993c.."
|
|
36
36
|
}
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
Restart Claude Desktop. All thirteen
|
|
39
|
+
Restart Claude Desktop. All thirteen Sonenta tools (`list_projects`,
|
|
40
40
|
`get_project_info`, `list_keys`, `list_untranslated_keys`,
|
|
41
41
|
`list_missing_keys`, `missing_keys_stats`, `acknowledge_missing_keys`,
|
|
42
42
|
`create_key`, `propose_translation`, `publish_cdn`,
|
|
@@ -53,7 +53,7 @@ wheel under `python/dist/`. The Node bin tries these in order:
|
|
|
53
53
|
2. **`uv run --project <bundled_dir> verbumia-mcp`** — uv-managed,
|
|
54
54
|
resolves deps from `pyproject.toml`.
|
|
55
55
|
3. **`pipx run --spec <bundled_wheel> verbumia-mcp`** — pipx-managed.
|
|
56
|
-
4. **Ad-hoc venv at `~/.
|
|
56
|
+
4. **Ad-hoc venv at `~/.sonenta/mcp-venv-<wheelhash>/`** — last-resort
|
|
57
57
|
fallback that requires only `python3 >= 3.12`. Slow first run, fast
|
|
58
58
|
thereafter.
|
|
59
59
|
|
|
@@ -63,10 +63,10 @@ Stdio is fully passthrough so the MCP JSON-RPC framing is preserved.
|
|
|
63
63
|
|
|
64
64
|
| Var | Required | Default | Notes |
|
|
65
65
|
|----------------------|----------|-----------------------------|--------------------------------------------------------|
|
|
66
|
-
| `
|
|
67
|
-
| `
|
|
68
|
-
| `
|
|
69
|
-
| `
|
|
66
|
+
| `SONENTA_API_KEY` | yes | | Bearer ApiKey token. `SONENTA_TOKEN` accepted (back-compat) |
|
|
67
|
+
| `SONENTA_BASE_URL` | no | `https://api.sonenta.com` | Self-host / staging override. `SONENTA_API_BASE` accepted (back-compat) |
|
|
68
|
+
| `SONENTA_PROJECTS` | no | (LLM picks per call) | CSV of project UUIDs. When >1, the LLM MUST pass `project_uuid` per call. |
|
|
69
|
+
| `SONENTA_PROJECT` | no | (legacy) | Singular fallback for v0.10.x users. Ignored when `SONENTA_PROJECTS` is set (warns). |
|
|
70
70
|
|
|
71
71
|
## Requirements
|
|
72
72
|
|
|
@@ -79,9 +79,9 @@ One of:
|
|
|
79
79
|
## Self-check
|
|
80
80
|
|
|
81
81
|
```bash
|
|
82
|
-
npx -y @
|
|
83
|
-
# -> @
|
|
84
|
-
# -> @
|
|
82
|
+
npx -y @sonenta/mcp --self-check
|
|
83
|
+
# -> @sonenta/mcp launchers detected: uvx, uv, python3
|
|
84
|
+
# -> @sonenta/mcp bundled wheel: <node_modules>/.../python/dist/verbumia_mcp-…whl
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
## License
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sonenta/mcp",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.1",
|
|
4
4
|
"description": "MCP server for Sonenta translation management \u2014 wires Claude Desktop and other MCP clients into your project's keys, missing-key feed, and translation drafts.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://sonenta.com",
|