Numbers Le

What numbers-le does

numbers-le exposes numeric extraction to MCP-compatible agents through the extract_numbers tool. The caller supplies the document content directly, optionally identifying its format and filename. Results preserve the order in which values appear and include the notation used to write each number, such as decimal, hexadecimal, binary, octal, scientific, or bigint.

The tool covers JSON and JSONC, YAML, CSV and TSV, TOML, INI, environment files, twelve programming and query languages, and unstructured text. Supported source-language families include Python, Rust, Go, Java, Kotlin, C#, C, C++, JavaScript, TypeScript, SQL, and shell. It can also process YAML streams containing multiple documents.

How it works

Call the tool with content and optionally provide format, filename, dedupe, and maxResults. JSON, source code, and plain text can return 1-based line and column positions when the location is exact. Parsed formats such as YAML, TOML, CSV, INI, and dotenv return values without guessed positions.

Numbers are filtered according to the selected parser. JSON quoted values remain strings, while CSV, INI, and environment values must contain a complete numeric value rather than a partial match. Finite values only are returned; NaN and infinity representations are excluded. Language-aware parsing recognizes forms such as 0xFF, 0b1010, digit separators, and numeric suffixes, while interpreting legacy octal according to the selected language dialect.

Results are limited to 500 by default. When the limit is reached, response metadata reports truncation. Plain-text fallback is available when a format is omitted or unrecognized, but it uses scanning heuristics rather than a grammar.

Setup and configuration

Install or run the MCP package from npm with:

npx -y numbers-le-mcp

A typical MCP configuration is:

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

The server uses stdio and requires no environment variables, API key, or server-specific configuration. It can also be installed globally with npm install -g numbers-le-mcp and launched as numbers-le-mcp. Claude Code can register it with claude mcp add numbers-le -- npx -y numbers-le-mcp; other MCP hosts can point their stdio configuration at the same command.

Tools and capabilities

• Extract numbers from structured data, source code, and plain text.
• Preserve document order and original numeric notation.
• Return exact line and column locations where supported.
• Deduplicate results and cap the response with caller options.
• Parse hexadecimal, binary, octal, scientific, bigint, and separated-digit notation.
• Accept content directly without filesystem or network access.

The project also provides an editor extension and command-line interfaces, but the MCP package focuses on agent calls through extract_numbers.