Back to Discover

numbers-le

connector

nolindnaidoo

Extract numeric values from config files, data files and plain text.

View on GitHub
0 starsSynced Aug 5, 2026

Install to Claude Code

/plugin marketplace add nolindnaidoo/numbers-le

README

Numbers-LE Logo

Numbers-LE: Zero Hassle Number Extraction

Pull every number out of the current file in one keystroke
JSON, YAML, CSV, TOML, INI, and Environment files

Install from VS Code Marketplace Open VSX downloads numbers-le-mcp on npm LE Tools


Numbers-LE Demo

Useful? A star or rating is how other developers find it — ★ GitHub · ★ Marketplace · ★ Open VSX

What it does

Open a file, press Ctrl+Alt+N (Cmd+Alt+N on Mac), and every numeric value in the document lands in a new editor — deduplicate and sort it from there. Works in VS Code and in VS Code–based editors like Cursor and VSCodium (installable from Open VSX).

  • Data validation — pull the numbers out of a config or fixture and eyeball ranges at a glance
  • Config audits — compare ports, thresholds, and limits across INI/TOML/.env files
  • CSV work — extract everything, one column, or several columns into separate documents

Use it from an AI agent

The same engine runs as an MCP server, so an agent can call it directly instead of you running a command.

EditorHow
VS Code 1.101+Nothing to install — the extension registers extract_numbers with agent mode
ZedNumbers-LEpending review
Claude Codeclaude mcp add numbers-le -- npx -y numbers-le-mcp
Cursor, Windsurf, anything elsepoint it at npx numbers-le-mcp
extract_numbers(content, format?, filename?, dedupe?, maxResults?)

Returns the values in document order, capped at 500 by default with meta.truncated. A format is optional — anything unrecognised is scanned as plain text rather than refused.

The server takes content and returns data — it reads no files and makes no network requests of its own. Published as numbers-le-mcp on npm and as io.github.nolindnaidoo/numbers-le in the MCP registry.

Configuring it by hand — any host with an MCP config file

Most hosts read a JSON config. Add one entry:

{
  "mcpServers": {
    "numbers-le": {
      "command": "npx",
      "args": ["-y", "numbers-le-mcp"]
    }
  }
}

-y skips the install prompt on first run. Pin a version if you would rather not track releases — numbers-le-mcp@2.2.1.

Prefer not to go through npx on every launch? Install it once and point at the binary instead:

npm install -g numbers-le-mcp
{
  "mcpServers": {
    "numbers-le": { "command": "numbers-le-mcp" }
  }
}

It speaks MCP over stdio and needs no environment variables, no API key and no configuration of its own. To check it before wiring it into anything:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y numbers-le-mcp

That prints the tool list and exits — if you see extract_numbers, the server works.

Supported formats

FormatWhat counts as a number
JSONNumber values anywhere in the structure. Quoted numbers ("42") are strings, not numbers, and are never extracted
YAMLNumber values, including hex/octal int forms and exponents; multi-document (---) streams extract from every document
TOMLInteger and float values (dates are not numbers)
CSVCells whose entire content is numeric — 19.99 counts, 12abc and 1,000 do not. No header inference: every row is data
INIValues whose entire content is numeric (INI values are inherently strings)
EnvironmentValues whose entire content is numeric (PORT=3000 yields 3000; VERSION=1.2.3 yields nothing)

The shared policy (one heuristics module, applied to every format): only finite numbers are extracted — NaN and inf/.inf never appear in results — and a coerced string must be numeric in full: plain decimals with optional sign, decimal point, and exponent. For unrecognized file types you can pick a format explicitly or fall back to a plain-text scan (no grammar: v1.2.3 reads as 1.2 and 0.3).

Commands

CommandDescription
Numbers-LE: Extract Numbers (Ctrl+Alt+N / Cmd+Alt+N)Extract all numbers from the active document
Numbers-LE: Deduplicate NumbersRemove duplicate numbers from the results
Numbers-LE: Sort NumbersSort results numerically or by magnitude
Numbers-LE: Toggle CSV StreamingFlip csv.streamingEnabled for large CSV files
Numbers-LE: Open SettingsOpen Numbers-LE settings
Numbers-LE: Help & TroubleshootingBuilt-in documentation

Settings

SettingDefaultDescription
numbers-le.openResultsSideBySidetrueOpen results beside the current editor
numbers-le.postProcess.openInNewFiletrueDedupe/Sort write to a new file instead of replacing the editor content
numbers-le.copyToClipboardEnabledfalseAlso copy results to the clipboard (non-CSV)
numbers-le.dedupeEnabledfalseDeduplicate automatically during extraction
numbers-le.sortEnabledfalseSort automatically during extraction
numbers-le.sortModeoffnumeric-asc/desc, magnitude-asc/desc
numbers-le.csv.streamingEnabledfalseIncremental CSV parsing for large files
numbers-le.showParseErrorsfalseSurface parse errors as notifications
numbers-le.notificationsLevelsilentall = every notification, important = warnings + errors, silent = errors only
numbers-le.safety.enabledtrueGuardrails for very large files/outputs
numbers-le.safety.fileSizeWarnBytes1000000Warn above this file size
numbers-le.safety.largeOutputLinesThreshold50000Offer Open/Copy/Cancel above this result count
numbers-le.safety.manyDocumentsThreshold8Confirm before opening this many column documents
numbers-le.statusBar.enabledtrueShow the status bar item
numbers-le.telemetryEnabledfalseLocal-only event log (see Privacy)

Languages

Twelve languages besides English:

German · Spanish · French · Indonesian · Italian · Japanese · Korean · Portuguese (Brazil) · Russian · Ukrainian · Vietnamese · Chinese (Simplified)

Both halves are covered — the manifest (command titles, setting names and descriptions) and everything shown while the extension runs (notifications, the status bar, quick-picks and prompts). The extension follows VS Code's display language, so it matches whatever the editor is already set to; no setting of its own.

Privacy & security

  • No network access. The extension never sends data anywhere. The telemetryEnabled setting only writes events to a local Output Channel you can inspect (Numbers-LE).
  • The MCP server holds the same line. It takes content as an argument and returns data: no filesystem access, no network calls, no telemetry. Your agent already has file-read tools, so duplicating them inside the server would add a path-traversal surface for no capability. check:mcp-bundle fails the build if the server ever imports something that could reach either.
  • Error notifications redact home directories and credential-shaped fragments.

Development

bun install
bun run build            # esbuild bundle -> dist/extension.js
bun run typecheck        # tsc --noEmit (includes tests)
bun run test             # vitest unit suite
bun run test:integration # real VS Code extension host
bun run lint             # biome
bun run package          # VSIX into release/

Architecture and conventions live in AGENTS.md. Changes are tracked in CHANGELOG.md.

Performance

InputSizeFoundTimeRateScan speed
JSON metrics2.18 MB120,00022.32 ms5,376,475/sec97.9 MB/s
CSV data0.93 MB150,00051.26 ms2,926,066/sec18.2 MB/s
INI config0.42 MB30,00020.05 ms1,496,430/sec20.7 MB/s

Median of 7 runs after warmup, on Apple M5 Pro, 24 GB RAM, Node 24.3.0. Inputs are generated by scripts/benchmark.ts rather than checked in, so the sizes above are exactly what was measured. Reproduce with bun run benchmark.

These are machine-specific and are not asserted in CI — a benchmark that gates a build only tells you how busy the runner was.

Testing

MetricCoverage
Statements89.74%
Branches80.93%
Functions96.42%
Lines91.30%

309 test cases across 21 files, plus an integration suite that runs in a real VS Code extension host and an end-to-end test that installs the built .vsix into a clean profile.

Generated from coverage/coverage-summary.json by scripts/coverage-readme.js; CI fails if this section drifts from a fresh run. Reproduce with bun run test:coverage.

More from the LE Family

Every tool in the family, one page: letools.dev

All ten also ship as MCP servers — npx <name>-mcp gives any agent the same engine.

  • String-LE - Extract string values for i18n from JSON, YAML, CSV, TOML, INI, and .env
  • Paths-LE - Extract file paths from JS/TS imports, JSON, HTML, CSS, TOML, CSV, and .env
  • EnvSync-LE - Spot missing keys across your .env files, with a markdown report
  • Regex-LE - Find, test, and validate regular expressions with ReDoS screening
  • Secrets-LE - Detect and sanitize credentials locally, before you commit
  • Scrape-LE - Check whether a page is scrapeable before you write the scraper
  • Colors-LE - Extract and analyze colors from CSS, SCSS, LESS, Stylus, HTML, JS/TS, and SVG
  • URLs-LE - Extract URLs from documentation, configs, and code
  • Dates-LE - Extract and analyze dates from logs, configs, and code

Also by nolindnaidoo

Rust

Contact DeveloperGitHub · LinkedIn

License

MIT © nolindnaidoo

Rendered live from nolindnaidoo/numbers-le's GitHub README — not stored, always reflects the source repo.

1 Install Method

NameDescriptionCategorySource
npm packageInstall via npm (stdio transport)mcp-servernumbers-le-mcp

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.