# io.github.hepter/i18n-codelens-mcp (npm · i18n-codelens-mcp)

Inspect, audit and safely edit i18n locale JSON files from AI agents.

- Trust score: 79/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- npm · `i18n-codelens-mcp`: 79/100 (this document), [markdown](https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp.md), [page](https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp)

## Channel facts

- Registry: `npm`
- Package: `i18n-codelens-mcp`
- Version: `2.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 12 of 23 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 17 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 81/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1517 tokens (~151/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 57/100
  - Stability observed for 17 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 87% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the io.github.hepter/i18n-codelens-mcp server?

io.github.hepter/i18n-codelens-mcp runs locally as an npm package, launched with npx -y i18n-codelens-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add hepter-i18n-codelens-mcp -- npx -y i18n-codelens-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "hepter-i18n-codelens-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "i18n-codelens-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "hepter-i18n-codelens-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "i18n-codelens-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add hepter-i18n-codelens-mcp -- npx -y i18n-codelens-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hepter-i18n-codelens-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "i18n-codelens-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add hepter-i18n-codelens-mcp --command npx --arg -y --arg i18n-codelens-mcp
```

### Hermes

```yaml
mcp_servers:
  hepter-i18n-codelens-mcp:
    command: "npx"
    args: ["-y", "i18n-codelens-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "hepter-i18n-codelens-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "i18n-codelens-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add hepter-i18n-codelens-mcp -t stdio -c npx -a -y i18n-codelens-mcp
```

### Other

```json
{
  "mcpServers": {
    "hepter-i18n-codelens-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "i18n-codelens-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-18 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-14 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-12 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 74, +3)

- [functional improvement] Stability: unverified → 0.27

### 2026-09-03 (score 71)

First indexed and scored.

## MCP tools (10)

### `i18n_project_info` (~58 tokens)

Inspect i18n project

Locales, key format (plain or namespace:key), key counts, resolved config and warnings. Call once per session before other tools.

Input parameters:

- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_get_translations` (~162 tokens)

Get translations

Values of specific keys in every (or selected) locale; null marks a missing translation. A key ending with '.' returns the whole namespace. Use includeValues:false for presence only.

Input parameters:

- `includeValues` (boolean): Default true. False returns the locales holding each key.
- `keys` (array, required): Exact keys, or namespaces ending with '.' (e.g. 'nav.').
- `limit` (number): Max items to return (default 50).
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `maxValueChars` (number): Truncate values (default 160).
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_search_keys` (~183 tokens)

Search keys

Find keys by substring of the key or the translated text, optionally under a key prefix. Keys missing from some locales are marked with "in". Add includeValues to see the text.

Input parameters:

- `caseSensitive` (boolean)
- `includeValues` (boolean): Default false.
- `keyPrefix` (string): Only keys starting with this prefix, e.g. 'component.chat.'.
- `limit` (number): Max items to return (default 50).
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `maxValueChars` (number)
- `query` (string): Substring to look for (case-insensitive by default).
- `searchIn` (string): Default both.
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_file_keys` (~92 tokens)

Keys used by a file

Translation keys referenced in one source file and the locales that lack each of them. Run after editing a component to verify its copy is complete.

Input parameters:

- `filePath` (string, required): Workspace-relative or absolute path of a source file.
- `includeComplete` (boolean): Default false: only count fully translated keys.
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_key_references` (~81 tokens)

Find key references

Where keys are used in code, as path:line:column, with exact totals. Useful before renaming or deleting a key.

Input parameters:

- `keys` (array, required)
- `limit` (number): Max locations per key (default 25).
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_audit` (~160 tokens)

Audit translations

Project-wide health check: keys missing in some locale (vs the base locale), placeholder mismatches, keys used in code but untranslated, and keys never referenced in code. Choose checks to keep the response small.

Input parameters:

- `baseLocale` (string): Reference locale (default: first locale).
- `checks` (array): Subset of missing, placeholders, code, unused. Default all.
- `includeReferences` (boolean): Attach code locations to untranslated keys.
- `limit` (number): Max items to return (default 50).
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_upsert_translations` (~111 tokens)

Add or update translations

Create or update keys in one call, with a value per locale. Writes immediately and never deletes keys. An existing value that differs is reported as a conflict unless overwrite:true. Reports missing locales and placeholder mismatches.

Input parameters:

- `dryRun` (boolean): Preview only (default false).
- `entries` (array, required)
- `overwrite` (boolean): Replace values that already differ (default false).
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_delete_keys` (~101 tokens)

Delete keys

Remove keys from all or selected locales. Previews by default; pass dryRun:false to delete (or confirm the dialog).

Input parameters:

- `dryRun` (boolean): Default true (preview). false deletes.
- `keys` (array, required)
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_rename_key` (~139 tokens)

Rename key or move namespace

Rename a key across locales, or move a whole namespace when from ends with '.' (e.g. 'nav.' -> 'menu.'). Refuses when a target exists. Previews by default; pass dryRun:false to apply.

Input parameters:

- `dryRun` (boolean): Default true (preview). false applies.
- `from` (string, required): Key, or namespace prefix ending with '.'.
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `to` (string, required)
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

### `i18n_format_resources` (~106 tokens)

Format locale files

Normalize JSON formatting and sort keys (top level only for mixed files). Previews by default; pass dryRun:false to rewrite.

Input parameters:

- `dryRun` (boolean): Default true (preview). false rewrites.
- `locales` (array): Locale tags to include, e.g. ['en','tr']. Default: all.
- `sortKeys` (boolean): Default true.
- `workspaceDir` (string): Sub-directory of the workspace root to operate on. Usually omitted.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp#diagnostics

## Score history

- 2026-09-20: 79
- 2026-09-19: 78
- 2026-09-18: 78
- 2026-09-17: 77
- 2026-09-16: 77
- 2026-09-15: 76
- 2026-09-14: 76
- 2026-09-13: 75
- 2026-09-12: 75
- 2026-09-11: 74
- 2026-09-10: 71
- 2026-09-09: 71
- 2026-09-08: 71
- 2026-09-07: 71
- 2026-09-06: 71
- 2026-09-05: 71
- 2026-09-04: 71
- 2026-09-03: 71

## Common questions

### What is the io.github.hepter/i18n-codelens-mcp server?

io.github.hepter/i18n-codelens-mcp is listed in the public MCP registry as io.github.hepter/i18n-codelens-mcp. Inspect, audit and safely edit i18n locale JSON files from AI agents. This page covers its npm package (i18n-codelens-mcp).

### Is the io.github.hepter/i18n-codelens-mcp server safe to use?

io.github.hepter/i18n-codelens-mcp scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.hepter/i18n-codelens-mcp server expose?

io.github.hepter/i18n-codelens-mcp exposes 10 tools: i18n_project_info, i18n_get_translations, i18n_search_keys, i18n_file_keys, i18n_key_references, and 5 more. Their descriptions and schemas cost roughly 1,193 tokens of context every time the server is loaded.

### Is the io.github.hepter/i18n-codelens-mcp server still maintained?

io.github.hepter/i18n-codelens-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.hepter/i18n-codelens-mcp server under?

io.github.hepter/i18n-codelens-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/i18n-codelens-mcp
- Socket report: https://socket.dev/npm/package/i18n-codelens-mcp
- Repository: https://github.com/hepter/i18n-codelens-mcp
- Changelog RSS feed: https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp.json
- HTML version of this page: https://verifymcp.io/servers/hepter-i18n-codelens-mcp/i18n-codelens-mcp
