@coo-quack/calc-mcp 1.6.1 → 1.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@coo-quack/calc-mcp",
-	"version": "1.6.1",
+	"version": "1.6.2",
 	"type": "module",
 	"bin": {
 		"calc-mcp": "dist/index.js"

package/docs/.vitepress/config.ts

@@ -1,56 +0,0 @@
-import { defineConfig } from "vitepress";
-
-export default defineConfig({
-	title: "Calc MCP",
-	description: "21 tools for things AI is bad at",
-	base: "/calc-mcp/",
-
-	themeConfig: {
-		logo: "/logo.svg",
-
-		nav: [
-			{ text: "Home", link: "/" },
-			{ text: "Tools", link: "/tools" },
-			{ text: "Install", link: "/install" },
-			{ text: "Examples", link: "/examples" },
-			{ text: "Changelog", link: "/changelog" },
-		],
-
-		sidebar: [
-			{
-				text: "Guide",
-				items: [
-					{ text: "Getting Started", link: "/" },
-					{ text: "Installation", link: "/install" },
-					{ text: "Examples", link: "/examples" },
-				],
-			},
-			{
-				text: "Reference",
-				items: [
-					{ text: "All Tools", link: "/tools" },
-					{ text: "Changelog", link: "/changelog" },
-				],
-			},
-		],
-
-		socialLinks: [
-			{ icon: "github", link: "https://github.com/coo-quack/calc-mcp" },
-			{
-				icon: "npm",
-				link: "https://www.npmjs.com/package/@coo-quack/calc-mcp",
-			},
-		],
-
-		footer: {
-			message: "Released under the MIT License.",
-			copyright: "Copyright © 2026 coo-quack",
-		},
-
-		search: {
-			provider: "local",
-		},
-	},
-
-	head: [["link", { rel: "icon", href: "/calc-mcp/favicon.ico" }]],
-});

package/docs/.vitepress/theme/index.ts

@@ -1,4 +0,0 @@
-import DefaultTheme from "vitepress/theme";
-import "./style.css";
-
-export default DefaultTheme;

package/docs/.vitepress/theme/style.css

@@ -1,21 +0,0 @@
-:root {
-	--vp-c-brand-1: #00a000;
-	--vp-c-brand-2: #00c000;
-	--vp-c-brand-3: #00e000;
-	--vp-c-brand-soft: rgba(0, 160, 0, 0.14);
-}
-
-.dark {
-	--vp-c-brand-1: #00d000;
-	--vp-c-brand-2: #00b000;
-	--vp-c-brand-3: #00a000;
-	--vp-c-brand-soft: rgba(0, 208, 0, 0.16);
-}
-
-.vp-doc a {
-	color: var(--vp-c-brand-1);
-}
-
-.vp-doc a:hover {
-	color: var(--vp-c-brand-2);
-}

package/docs/changelog.md

@@ -1,117 +0,0 @@
-# Changelog
-
-All notable changes to Calc MCP are documented here.
-
-## v1.6.1 (2026-02-12)
-
-### Bug Fixes
-
-- **hash** — Replace `Bun.CryptoHasher` with `node:crypto` for Node.js compatibility (#18)
-
-## v1.6.0 (2026-02-12)
-
-### Features
-
-- **Documentation site** — Full VitePress-powered docs at [coo-quack.github.io/calc-mcp](https://coo-quack.github.io/calc-mcp/) with tool reference, examples, install guides, and changelog (#13)
-
-### Documentation
-
-- Added documentation site link to README
-- Added release checklist to CONTRIBUTING.md (#15)
-- Updated npx examples with `--prefix /tmp` for better node_modules compatibility
-- Added common ignore patterns to .gitignore
-
-## v1.5.0 (2026-02-11)
-
-### Features
-
-- **Password generation** — Fine-grained options: `uppercase`, `numbers`, `symbols` (on/off), `readable` mode (excludes ambiguous chars like l/1/I/O/0/o), `excludeChars` for custom exclusions
-- **Shuffle** — Fisher-Yates algorithm with `crypto.getRandomValues` for unbiased list shuffling
-
-### Documentation
-
-- README title: `@coo-quack/calc-mcp` → `Calc MCP`
-- Added "Why?" section with AI-alone vs calc-mcp comparison
-- Quick Start moved to top
-- Install guides consolidated (Claude Desktop/Cursor/Windsurf share same JSON format)
-
-### Tests
-
-- Random tool tests: 12 → 27 (+15)
-- Total: 194 tests, 280 assertions
-
-## v1.4.0 (2026-02-11)
-
-### Features
-
-- **Time conversion** — ms, s, min, h, d, wk, mo, yr (now 8 categories, 72 units)
-- **`--version` flag** — `npx @coo-quack/calc-mcp --version`
-
-### Improvements
-
-- serverInfo.version synced with package.json (was hardcoded "0.1.0")
-- Error messages now list all supported units on unknown unit
-- Semver test coverage: 9 → 23 tests
-- CI git config for tag authoring
-- README badges (npm, CI, license)
-- CONTRIBUTING.md added
-- GitHub topics set
-- README examples: Japanese text replaced with English alternatives
-
-## v1.3.0 (2026-02-11)
-
-### Documentation
-
-- Overhaul README with natural language examples (22 verified examples)
-- Add install guides for Claude Code, Claude Desktop, VS Code, Cursor, Windsurf
-- Add unit conversion coverage details (7 categories, 58 units)
-- Add encode/decode examples (Base64, URL, HTML)
-
-## v1.1.0 (2026-02-11)
-
-### Features
-
-- **random**: Add UUID v7 support (`uuidVersion: "v7"`) — Time-ordered UUIDs, ideal for database primary keys
-
-## v1.0.0 (2026-02-11)
-
-### Features
-
-Initial release with **21 MCP tools** for calculations and operations AI models struggle with:
-
-- **random** — UUID (v4), ULID, secure password, random number
-- **hash** — SHA-1, SHA-256, SHA-512, MD5
-- **base64** — Encode/decode Base64
-- **encode** — URL encode/decode, HTML entity encode/decode
-- **datetime** — Current time, convert, format, Unix timestamp
-- **count** — Character, word, line, byte counting (grapheme-aware)
-- **math** — Precise math evaluation via mathjs
-- **date** — Date arithmetic (add/subtract/diff)
-- **regex** — Test, match, replace with regex
-- **base** — Number base conversion (bin/oct/dec/hex/custom)
-- **diff** — Text diff between two strings
-- **json_validate** — JSON schema validation
-- **cron_parse** — Cron expression to human-readable description
-- **luhn** — Luhn algorithm validation (credit cards, etc.)
-- **ip** — IPv4/IPv6 parsing, CIDR subnet info
-- **color** — Color format conversion (hex/rgb/hsl/hwb)
-- **convert** — Unit conversion (length, weight, temp, data, time)
-- **char_info** — Unicode character info (codepoint, name, category)
-- **jwt_decode** — Decode JWT tokens (header + payload)
-- **url_parse** — URL parsing into components
-- **semver** — Semantic versioning operations (compare, satisfy, sort)
-
-### CI/CD
-
-- GitHub Actions: test + lint on push/PR
-- Publish workflow: test + lint gate before npm publish on tag
-
-### Infrastructure
-
-- Biome for linting and formatting
-- Renovate with OSV vulnerability alerts
-- 160 tests, 92%+ line coverage
-
----
-
-For the latest changes, see [GitHub Releases](https://github.com/coo-quack/calc-mcp/releases).

package/docs/examples.md

@@ -1,419 +0,0 @@
-# Examples
-
-Ask in natural language — the AI picks the right tool automatically. Here are real examples you can try:
-
-## Math & Numbers
-
-### Calculations
-
-```
-What's 10 + 34 × 341 ÷ 23?
-→ 514.087 (math)
-
-Calculate sqrt(144) + 2^8
-→ 268 (math)
-
-What's the sum of [10, 20, 30, 40, 50]?
-→ 150 (math)
-```
-
-### Statistics
-
-```
-Calculate mean and stddev of [1, 2, 3, 4, 5]
-→ { mean: 3, median: 3, stddev: 1.414, min: 1, max: 5 } (math)
-
-What's the median of [100, 50, 200, 75, 150]?
-→ 100 (math)
-```
-
-### Base Conversion
-
-```
-Convert 255 to binary
-→ 11111111 (base)
-
-Convert FF from hex to decimal
-→ 255 (base)
-
-Convert 12 from decimal to base 5
-→ 22 (base)
-```
-
-### Card Validation
-
-```
-Is 4539578763621486 a valid card number?
-→ true (luhn)
-
-Generate check digit for 453957876362148
-→ 6 (luhn)
-```
-
-## Text & Encoding
-
-### Counting
-
-```
-How many characters in "Hello, World! 🌍"?
-→ 15 chars, 18 bytes (count)
-
-Count words in "The quick brown fox jumps"
-→ 5 words (count)
-
-How many lines in this text? (multiline input)
-→ 10 lines (count)
-```
-
-### Base64
-
-```
-Base64 encode "Hello World"
-→ SGVsbG8gV29ybGQ= (base64)
-
-Base64 decode "eyJhbGciOiJIUzI1NiJ9"
-→ {"alg":"HS256"} (base64)
-```
-
-### URL Encoding
-
-```
-URL-encode "hello world"
-→ hello%20world (encode)
-
-URL-decode "hello%20world"
-→ "hello world" (encode)
-
-HTML-encode "<script>alert('XSS')</script>"
-→ &lt;script&gt;alert(&#39;XSS&#39;)&lt;/script&gt; (encode)
-
-HTML-decode "&lt;script&gt;"
-→ <script> (encode)
-```
-
-### Hashing
-
-```
-SHA-256 hash of "password123"
-→ ef92b778bafe771e89b862eebf... (hash)
-
-MD5 of "hello world"
-→ 5eb63bbbe01eeed093cb22bb8f5acdc3 (hash)
-
-CRC32 checksum of "test"
-→ d87f7e0c (hash)
-```
-
-## Date & Time
-
-### Current Time
-
-```
-What time is it in New York?
-→ 2026-02-10T19:00:00-05:00 (datetime)
-
-What time is it in Tokyo?
-→ 2026-02-11T09:00:00+09:00 (datetime)
-
-What's the current UNIX timestamp?
-→ 1707638400 (datetime)
-```
-
-### Date Arithmetic
-
-```
-What's 100 days after 2026-02-11?
-→ 2026-05-22 (date)
-
-What's 30 days before 2026-03-01?
-→ 2026-01-30 (date)
-
-Add 6 months to 2026-01-15
-→ 2026-07-15 (date)
-```
-
-### Date Differences
-
-```
-How many days between 2026-01-01 and 2026-12-31?
-→ 364 days (date)
-
-Difference in months between 2025-01-01 and 2026-01-01
-→ 12 months (date)
-```
-
-### Weekdays
-
-```
-What day of the week is 2026-02-11?
-→ Wednesday (水曜日) (date)
-```
-
-### Cron Expressions
-
-```
-When does "30 9 * * 1-5" run?
-→ Mon–Fri at 9:30 (cron_parse)
-
-Parse "0 0 1 * *"
-→ Monthly on the 1st at midnight (cron_parse)
-
-Next 5 runs of "*/15 * * * *"
-→ Every 15 minutes: 10:00, 10:15, 10:30... (cron_parse)
-```
-
-## Generation
-
-### UUIDs
-
-```
-Generate a UUID v4
-→ 550e8400-e29b-41d4-a716-446655440000 (random)
-
-Generate a UUID v7 (time-ordered)
-→ 019c4b54-aad2-7e52-8a3b-... (random)
-
-Generate a ULID
-→ 01HN8B6ZK9PQRSTVWXY0123456 (random)
-```
-
-### Passwords
-
-```
-Generate a 20-character password
-→ hT9jZDojX6sHRJt8vaKS (random)
-
-Generate a readable password (no ambiguous chars)
-→ rTbPkWnF8sHuDxYz (random)
-
-Generate a 16-char password with only letters and numbers
-→ aB3dE5fG7hJ9kL2m (random)
-
-Generate a password without symbols
-→ xYz4AbC8DeFgHiJk (random)
-```
-
-### Random Numbers
-
-```
-Random number between 1 and 100
-→ 42 (random)
-
-Random number between 1 and 6 (dice roll)
-→ 4 (random)
-```
-
-### Shuffle
-
-```
-Shuffle ["Alice", "Bob", "Charlie"]
-→ ["Charlie", "Alice", "Bob"] (random)
-
-Randomize order: ["A", "B", "C", "D", "E"]
-→ ["D", "A", "E", "B", "C"] (random)
-```
-
-## Conversion
-
-### Length
-
-```
-100 miles in kilometers?
-→ 160.93 km (convert)
-
-5 feet in meters?
-→ 1.524 m (convert)
-```
-
-### Temperature
-
-```
-72°F in Celsius?
-→ 22.22°C (convert)
-
-100°C in Fahrenheit?
-→ 212°F (convert)
-
-300 Kelvin in Celsius?
-→ 26.85°C (convert)
-```
-
-### Weight
-
-```
-10 pounds in kilograms?
-→ 4.536 kg (convert)
-
-500 grams in ounces?
-→ 17.637 oz (convert)
-```
-
-### Area (including Japanese units)
-
-```
-10 tsubo in square meters?
-→ 33.06 m² (convert)
-
-100 m² in tatami?
-→ 60.5 tatami (convert)
-
-1 acre in square meters?
-→ 4046.86 m² (convert)
-```
-
-### Data
-
-```
-5 GB in megabytes?
-→ 5120 MB (convert)
-
-1000 kilobytes in bits?
-→ 8192000 bits (convert)
-```
-
-### Time
-
-```
-3600 seconds in hours?
-→ 1 hour (convert)
-
-2 weeks in days?
-→ 14 days (convert)
-
-1000000 milliseconds in minutes?
-→ 16.667 minutes (convert)
-```
-
-## Analysis & Parsing
-
-### Regular Expressions
-
-```
-Extract numbers from "abc123def456"
-→ ["123", "456"] (regex)
-
-Does "hello@example.com" match an email pattern?
-→ true (regex)
-
-Replace all spaces with dashes in "hello world"
-→ "hello-world" (regex)
-```
-
-### Text Diff
-
-```
-Edit distance: "kitten" → "sitting"
-→ 3 (diff)
-
-Line diff between two code snippets
-→ - old line
-→ + new line
-→   unchanged line
-(diff)
-```
-
-### IP Addresses
-
-```
-IP range of 192.168.1.0/24?
-→ 192.168.1.1 – .254 (254 hosts) (ip)
-
-Is 192.168.1.50 in 192.168.1.0/24?
-→ true (ip)
-
-Parse IPv6 address 2001:db8::1
-→ { version: 6, address: "2001:0db8:0000:..." } (ip)
-```
-
-### Colors
-
-```
-Convert #FF5733 to RGB
-→ rgb(255, 87, 51) (color)
-
-Convert rgb(100, 200, 50) to HSL
-→ hsl(100, 60%, 49%) (color)
-
-Convert hsl(120, 100%, 50%) to HEX
-→ #00FF00 (color)
-```
-
-### Semver
-
-```
-Does 1.5.3 satisfy ^1.0.0?
-→ true (semver)
-
-Compare 2.0.0 and 1.9.9
-→ 2.0.0 is greater (semver)
-
-Is "1.2.3-beta.1" a valid semver?
-→ true (semver)
-```
-
-## Decode & Parse
-
-### JSON Validation
-
-```
-Is '{"name":"test"}' valid JSON?
-→ valid, object, keys: ["name"] (json_validate)
-
-Validate CSV with 3 columns
-→ valid, 10 rows, 3 columns (json_validate)
-
-Is this valid XML? (XML input)
-→ valid (json_validate)
-```
-
-### JWT Decoding
-
-```
-Decode this JWT: eyJhbGci...
-→ { 
-    header: { alg: "HS256", typ: "JWT" }, 
-    payload: { sub: "1234567890", name: "John Doe" } 
-  }
-(jwt_decode)
-```
-
-### URL Parsing
-
-```
-Parse https://example.com/search?q=hello&lang=en
-→ {
-    host: "example.com",
-    pathname: "/search",
-    searchParams: { q: "hello", lang: "en" }
-  }
-(url_parse)
-
-Extract query params from https://api.github.com/search?q=mcp&sort=stars
-→ { q: "mcp", sort: "stars" } (url_parse)
-```
-
-### Unicode Info
-
-```
-Unicode info for "€"
-→ U+20AC, Currency Symbols (char_info)
-
-What's the code point for "🌍"?
-→ U+1F30D, Miscellaneous Symbols and Pictographs (char_info)
-
-Character info for "あ"
-→ U+3042, Hiragana (char_info)
-```
-
----
-
-## Tips for Natural Language Queries
-
-The AI automatically selects the right tool based on your question. For best results:
-
-1. **Be specific** — "Convert 100°F to Celsius" is better than "temperature conversion"
-2. **Include units** — "5 miles in km" is clearer than "5 miles"
-3. **Use examples** — "Extract numbers from 'abc123'" shows what you want
-4. **Ask naturally** — The AI understands conversational queries
-
-Try asking in your own words — the AI will figure it out! 🚀

package/docs/index.md

@@ -1,101 +0,0 @@
----
-layout: home
-
-hero:
-  name: Calc MCP
-  text: 21 tools for things AI is bad at
-  tagline: Deterministic math, cryptographic randomness, accurate date arithmetic, encoding, hashing, and more
-  actions:
-    - theme: brand
-      text: Get Started
-      link: /install
-    - theme: alt
-      text: View Tools
-      link: /tools
-    - theme: alt
-      text: GitHub
-      link: https://github.com/coo-quack/calc-mcp
-
-features:
-  - icon: 🧮
-    title: Precise Math
-    details: No more hallucinated calculations. Evaluate complex expressions with mathjs, compute statistics, all deterministic.
-  - icon: 🎲
-    title: True Randomness
-    details: Cryptographically secure UUIDs, ULIDs, passwords, and shuffling. No fake random numbers from AI.
-  - icon: 📅
-    title: Accurate Dates
-    details: Timezone conversion, date arithmetic, cron parsing. No more guessing what day it is 100 days from now.
-  - icon: 🔐
-    title: Hashing & Encoding
-    details: SHA-256, Base64, URL encoding, JWT decoding. Real cryptographic operations, not hallucinated hashes.
-  - icon: 🌈
-    title: Conversions
-    details: 8 categories, 72 units. Length, weight, temperature, area, volume, speed, data, time. Including Japanese units (tsubo, tatami).
-  - icon: 🔍
-    title: Parsing & Validation
-    details: IP addresses, URLs, JSON, semver, Luhn checksums. Deterministic validation and parsing.
----
-
-## Why Calc MCP?
-
-LLMs are incredible at natural language understanding, but terrible at things that require **precision**.
-
-| AI alone | With calc-mcp |
-|----------|---------------|
-| "10 + 34 × 341 ÷ 23 = 507.8" ❌ | `514.087` ✅ (math) |
-| "Here's a UUID: 550e8400-..." 🤷 fake | Cryptographically random UUID v4/v7 ✅ (random) |
-| "100 days from now is..." 🤔 guess | `2026-05-22` ✅ (date) |
-| "SHA-256 of password123 is..." 💀 hallucinated | `ef92b778bafe...` ✅ (hash) |
-
-Calc MCP gives your AI assistant the tools to **delegate** these tasks to deterministic, tested code.
-
-## Quick Start
-
-```bash
-# Claude Code
-claude mcp add -s user calc-mcp -- npx -y @coo-quack/calc-mcp
-```
-
-Works with **Claude Desktop**, **VS Code Copilot**, **Cursor**, **Windsurf** — see [installation guides](/install).
-
-## Usage
-
-Just ask in natural language. The AI picks the right tool automatically:
-
-```
-You: What's 10 + 34 × 341 ÷ 23?
-AI: [uses math tool] → 514.087
-
-You: Generate a UUID v7
-AI: [uses random tool] → 019c4b54-aad2-7e52-8a3b-...
-
-You: What's 100 days after 2026-02-11?
-AI: [uses date tool] → 2026-05-22
-
-You: SHA-256 hash of "password123"
-AI: [uses hash tool] → ef92b778bafe771e89b862eebf...
-```
-
-See more [examples →](/examples)
-
-## All 21 Tools
-
-| Category | Tools |
-|----------|-------|
-| **Math** | math, count, convert, base |
-| **Random** | random (UUID, ULID, password, number, shuffle) |
-| **Dates** | datetime, date, cron_parse |
-| **Text** | base64, encode, hash, regex, diff, char_info |
-| **Validation** | json_validate, luhn, semver |
-| **Parsing** | ip, color, jwt_decode, url_parse |
-
-[View all tools →](/tools)
-
-## Features
-
-- ✅ **21 MCP tools** covering calculations, randomness, dates, encoding, parsing
-- ✅ **Tested** — 194 tests, 280 assertions, 92%+ coverage
-- ✅ **Fast** — Pure JavaScript/TypeScript, no heavy dependencies
-- ✅ **Cross-platform** — Works with Claude Desktop, VS Code, Cursor, Windsurf
-- ✅ **MIT Licensed** — Free to use, modify, distribute

package/docs/install.md

@@ -1,163 +0,0 @@
-# Installation
-
-Calc MCP works with any MCP-compatible client. Below are setup guides for popular AI assistants.
-
-## Claude Code
-
-The fastest way to add Calc MCP to Claude Code:
-
-```bash
-claude mcp add -s user calc-mcp -- npx --prefix /tmp -y @coo-quack/calc-mcp
-```
-
-This adds the server to your user config (`~/.config/openclaw/config.yml`).
-
-To verify it's working:
-
-```bash
-claude mcp list
-```
-
-You should see `calc-mcp` in the list.
-
-## Claude Desktop
-
-Add to your Claude Desktop config file:
-
-**macOS:**
-```bash
-~/Library/Application Support/Claude/claude_desktop_config.json
-```
-
-**Windows:**
-```bash
-%APPDATA%\Claude\claude_desktop_config.json
-```
-
-**Config:**
-```json
-{
-  "mcpServers": {
-    "calc-mcp": {
-      "command": "npx",
-      "args": ["--prefix", "/tmp", "-y", "@coo-quack/calc-mcp"]
-    }
-  }
-}
-```
-
-After editing, restart Claude Desktop. You should see "MCP" in the bottom-right corner with the 21 tools available.
-
-## Cursor
-
-Add to `~/.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "calc-mcp": {
-      "command": "npx",
-      "args": ["--prefix", "/tmp", "-y", "@coo-quack/calc-mcp"]
-    }
-  }
-}
-```
-
-Restart Cursor after adding the config.
-
-## Windsurf
-
-Add to `~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "calc-mcp": {
-      "command": "npx",
-      "args": ["--prefix", "/tmp", "-y", "@coo-quack/calc-mcp"]
-    }
-  }
-}
-```
-
-Restart Windsurf after adding the config.
-
-## VS Code (GitHub Copilot)
-
-For workspace-specific setup, add `.vscode/mcp.json` in your project:
-
-```json
-{
-  "servers": {
-    "calc-mcp": {
-      "command": "npx",
-      "args": ["--prefix", "/tmp", "-y", "@coo-quack/calc-mcp"]
-    }
-  }
-}
-```
-
-Reload VS Code after creating the file.
-
-## Direct Usage
-
-You can also run the server directly for testing:
-
-```bash
-npx --prefix /tmp -y @coo-quack/calc-mcp
-```
-
-Or install globally:
-
-```bash
-npm install -g @coo-quack/calc-mcp
-calc-mcp
-```
-
-## Troubleshooting
-
-### "npx: command not found"
-
-Make sure Node.js (v18+) is installed:
-
-```bash
-node --version
-npm --version
-```
-
-Install from [nodejs.org](https://nodejs.org/) if needed.
-
-### Tools not showing up
-
-1. **Restart the app** after editing the config file
-2. **Check the config path** — make sure you edited the right file
-3. **Validate JSON** — use a JSON validator to check for syntax errors
-4. **Check logs** — Claude Desktop and other apps may have logs showing connection errors
-
-### "calc-mcp: command not found" inside a Node.js project
-
-If you run `npx` inside a directory that contains `node_modules`, npx may fail with:
-
-```
-sh: calc-mcp: command not found
-```
-
-This happens because npx resolves the scoped package locally but fails to link the binary correctly. All the examples on this page already include the fix (`--prefix /tmp`), which forces npx to use a separate directory for package resolution:
-
-```bash
-npx --prefix /tmp -y @coo-quack/calc-mcp
-```
-
-### Version info
-
-To check the installed version:
-
-```bash
-npx --prefix /tmp @coo-quack/calc-mcp --version
-```
-
-## Next Steps
-
-- [View all tools →](/tools)
-- [See examples →](/examples)
-- [Read the changelog →](/changelog)

package/docs/public/logo.svg

@@ -1,79 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
-  <defs>
-    <!-- Background gradient -->
-    <linearGradient id="bgGrad" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#5CB85C"/>
-      <stop offset="100%" stop-color="#2E7D32"/>
-    </linearGradient>
-    <!-- Calculator body gradient -->
-    <linearGradient id="bodyGrad" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#FDFDFD"/>
-      <stop offset="100%" stop-color="#E8E8E8"/>
-    </linearGradient>
-    <!-- Display gradient -->
-    <linearGradient id="displayGrad" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#1A1A2E"/>
-      <stop offset="100%" stop-color="#16213E"/>
-    </linearGradient>
-    <!-- Green button gradient -->
-    <linearGradient id="greenBtn" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#6ABF47"/>
-      <stop offset="100%" stop-color="#4A8C2A"/>
-    </linearGradient>
-    <!-- Orange button gradient -->
-    <linearGradient id="orangeBtn" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#FF8C42"/>
-      <stop offset="100%" stop-color="#E8621A"/>
-    </linearGradient>
-    <!-- Gray button gradient -->
-    <linearGradient id="grayBtn" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#E0E0E0"/>
-      <stop offset="100%" stop-color="#BDBDBD"/>
-    </linearGradient>
-    <!-- Accent green button -->
-    <linearGradient id="accentBtn" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="#4CAF50"/>
-      <stop offset="100%" stop-color="#2E7D32"/>
-    </linearGradient>
-    <!-- Shadow filter -->
-    <filter id="shadow" x="-10%" y="-10%" width="130%" height="130%">
-      <feDropShadow dx="0" dy="4" stdDeviation="8" flood-color="#000" flood-opacity="0.3"/>
-    </filter>
-    <filter id="btnShadow" x="-20%" y="-20%" width="140%" height="160%">
-      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#000" flood-opacity="0.15"/>
-    </filter>
-    <filter id="innerGlow">
-      <feDropShadow dx="0" dy="1" stdDeviation="1" flood-color="#FFF" flood-opacity="0.3"/>
-    </filter>
-  </defs>
-
-  <!-- Background rounded square -->
-  <rect x="0" y="0" width="512" height="512" rx="96" ry="96" fill="url(#bgGrad)"/>
-  <!-- Subtle highlight on top-left -->
-  <rect x="0" y="0" width="512" height="256" rx="96" ry="96" fill="url(#bgGrad)" opacity="0.15" style="filter: blur(2px)"/>
-
-  <!-- Calculator body -->
-  <rect x="88" y="64" width="336" height="400" rx="36" ry="36" fill="url(#bodyGrad)" filter="url(#shadow)"/>
-
-  <!-- Display -->
-  <rect x="116" y="92" width="280" height="88" rx="16" ry="16" fill="url(#displayGrad)"/>
-  <!-- Display dots -->
-  <circle cx="336" cy="136" r="4" fill="#4A5568" opacity="0.6"/>
-  <circle cx="356" cy="136" r="4" fill="#4A5568" opacity="0.6"/>
-  <circle cx="376" cy="136" r="4" fill="#48BB78"/>
-
-  <!-- Row 1: Green, Green, Orange -->
-  <rect x="116" y="204" width="76" height="60" rx="14" ry="14" fill="url(#greenBtn)" filter="url(#btnShadow)"/>
-  <rect x="218" y="204" width="76" height="60" rx="14" ry="14" fill="url(#greenBtn)" filter="url(#btnShadow)"/>
-  <rect x="320" y="204" width="76" height="60" rx="14" ry="14" fill="url(#orangeBtn)" filter="url(#btnShadow)"/>
-
-  <!-- Row 2: Gray, Gray, Orange -->
-  <rect x="116" y="284" width="76" height="60" rx="14" ry="14" fill="url(#grayBtn)" filter="url(#btnShadow)"/>
-  <rect x="218" y="284" width="76" height="60" rx="14" ry="14" fill="url(#grayBtn)" filter="url(#btnShadow)"/>
-  <rect x="320" y="284" width="76" height="60" rx="14" ry="14" fill="url(#orangeBtn)" filter="url(#btnShadow)"/>
-
-  <!-- Row 3: Gray, Gray, Accent Green -->
-  <rect x="116" y="364" width="76" height="60" rx="14" ry="14" fill="url(#grayBtn)" filter="url(#btnShadow)"/>
-  <rect x="218" y="364" width="76" height="60" rx="14" ry="14" fill="url(#grayBtn)" filter="url(#btnShadow)"/>
-  <rect x="320" y="364" width="76" height="60" rx="14" ry="14" fill="url(#accentBtn)" filter="url(#btnShadow)"/>
-</svg>

package/docs/tools.md

@@ -1,427 +0,0 @@
-# All Tools
-
-Calc MCP provides 21 tools for operations that AI models struggle with. Each tool is designed to be called automatically by your AI assistant when you ask questions in natural language.
-
-## Math & Numbers
-
-### math
-
-Evaluate mathematical expressions or compute statistics on numbers.
-
-**Parameters:**
-- `expression` (string, optional) — Math expression to evaluate
-- `action` (enum, optional) — `eval` (default) or `statistics`
-- `values` (array of numbers, optional) — Array of numbers for statistics
-
-**Examples:**
-```
-What's 10 + 34 × 341 ÷ 23?
-→ 514.087
-
-Calculate mean and stddev of [1, 2, 3, 4, 5]
-→ { mean: 3, median: 3, stddev: 1.414, ... }
-```
-
-### count
-
-Count characters (grapheme-aware), words, lines, and bytes in text.
-
-**Parameters:**
-- `text` (string) — Text to analyze
-- `encoding` (enum, optional) — `utf8` (default) or `shift_jis` for byte count
-
-**Examples:**
-```
-How many characters in "Hello, World! 🌍"?
-→ 15 chars, 18 bytes
-
-Count words in "The quick brown fox"
-→ 4 words
-```
-
-### base
-
-Convert numbers between different bases (2–36).
-
-**Parameters:**
-- `value` (string | number) — Value to convert
-- `from` (number) — Source base (2–36)
-- `to` (number) — Target base (2–36)
-
-**Examples:**
-```
-Convert 255 to binary
-→ 11111111
-
-Convert FF from hex to decimal
-→ 255
-```
-
-### convert
-
-Convert between units across 8 categories: length, weight, temperature, area, volume, speed, data, time.
-
-**Parameters:**
-- `value` (number) — Value to convert
-- `from` (string) — Source unit
-- `to` (string) — Target unit
-- `category` (enum, optional) — Category (auto-detected if omitted)
-
-**Supported units:**
-- **Length:** m, km, cm, mm, in, ft, yd, mi, nm, um
-- **Weight:** kg, g, mg, lb, oz, t, st
-- **Temperature:** c, f, k (Celsius, Fahrenheit, Kelvin)
-- **Area:** m2, km2, cm2, ha, acre, ft2, in2, tsubo, jo, tatami
-- **Volume:** l, ml, m3, gal, qt, pt, cup, floz, tbsp, tsp
-- **Speed:** m/s, km/h, mph, kn, ft/s
-- **Data:** b, kb, mb, gb, tb, pb, bit, kbit, mbit
-- **Time:** ms, s, min, h, d, wk, mo, yr
-
-**Examples:**
-```
-100 miles in kilometers?
-→ 160.93 km
-
-72°F in Celsius?
-→ 22.22°C
-
-10 tsubo in square meters?
-→ 33.06 m²
-```
-
-## Random Generation
-
-### random
-
-Generate cryptographically random values: UUID, ULID, password, number, or shuffle a list.
-
-**Parameters:**
-- `type` (enum) — `uuid`, `ulid`, `password`, `number`, or `shuffle`
-- `uuidVersion` (enum, optional) — `v4` (random, default) or `v7` (time-ordered)
-- `length` (number, optional) — Length for password (default: 16, max: 256)
-- `min` (number, optional) — Minimum value for number (default: 0)
-- `max` (number, optional) — Maximum value for number (default: 100)
-- `charset` (string, optional) — Custom character set for password
-- `uppercase` (boolean, optional) — Include uppercase letters (default: true)
-- `numbers` (boolean, optional) — Include numbers (default: true)
-- `symbols` (boolean, optional) — Include symbols (default: true)
-- `excludeChars` (string, optional) — Characters to exclude (e.g., `"\\|{}"`)
-- `readable` (boolean, optional) — Exclude ambiguous characters (l/1/I/O/0/o)
-- `items` (array of strings, optional) — Items to shuffle (for `type=shuffle`)
-
-**Examples:**
-```
-Generate a UUID v7
-→ 019c4b54-aad2-7e52-8a3b-...
-
-Generate a readable 20-char password
-→ hT9jZDojX6sHRJt8vaKS
-
-Shuffle ["Alice", "Bob", "Charlie"]
-→ ["Charlie", "Alice", "Bob"]
-
-Random number between 1 and 100
-→ 42
-```
-
-## Date & Time
-
-### datetime
-
-Get current time, convert timezones, format datetime, or work with UNIX timestamps.
-
-**Parameters:**
-- `action` (enum) — `now`, `convert`, `format`, or `timestamp`
-- `timezone` (string, optional) — IANA timezone (e.g., `Asia/Tokyo`, `America/New_York`)
-- `datetime` (string, optional) — ISO8601 datetime string for convert/format
-- `fromTimezone` (string, optional) — Source timezone for conversion
-- `toTimezone` (string, optional) — Target timezone for conversion
-- `format` (string, optional) — Output format: `iso`, `date`, `time`, `full`, or Intl options
-- `timestamp` (number, optional) — UNIX timestamp in seconds for timestamp action
-
-**Examples:**
-```
-What time is it in New York?
-→ 2026-02-10T19:00:00-05:00
-
-Convert 1609459200 to ISO8601
-→ 2021-01-01T00:00:00Z
-```
-
-### date
-
-Perform date arithmetic: difference, add/subtract, get weekday, or convert to wareki (Japanese era).
-
-**Parameters:**
-- `action` (enum) — `diff`, `add`, `weekday`, or `wareki`
-- `date` (string) — Date string (ISO8601)
-- `date2` (string, optional) — Second date for diff
-- `amount` (number, optional) — Amount to add
-- `unit` (enum, optional) — `days`, `months`, `years`, `hours`, `minutes`
-
-**Examples:**
-```
-What's 100 days after 2026-02-11?
-→ 2026-05-22
-
-Difference between 2026-01-01 and 2026-12-31
-→ 364 days
-
-What day of the week is 2026-02-11?
-→ Wednesday (水曜日)
-```
-
-### cron_parse
-
-Parse cron expressions into human-readable descriptions and get next occurrences.
-
-**Parameters:**
-- `expression` (string) — Cron expression (5 fields: min hour dom mon dow)
-- `count` (number, optional) — Number of next occurrences to return (default: 5)
-- `timezone` (string, optional) — IANA timezone (default: UTC)
-
-**Examples:**
-```
-When does "30 9 * * 1-5" run?
-→ Mon–Fri at 9:30, next runs: ...
-```
-
-## Text Processing
-
-### hash
-
-Compute cryptographic hashes: MD5, SHA-1, SHA-256, SHA-512, CRC32.
-
-**Parameters:**
-- `input` (string) — String to hash
-- `algorithm` (enum) — `md5`, `sha1`, `sha256`, `sha512`, or `crc32`
-
-**Examples:**
-```
-SHA-256 hash of "password123"
-→ ef92b778bafe771e89b862eebf...
-
-MD5 of "hello world"
-→ 5eb63bbbe01eeed093cb22bb8f5acdc3
-```
-
-### base64
-
-Encode or decode Base64 strings.
-
-**Parameters:**
-- `input` (string) — String to encode or decode
-- `action` (enum) — `encode` or `decode`
-
-**Examples:**
-```
-Base64 encode "Hello World"
-→ SGVsbG8gV29ybGQ=
-
-Base64 decode "eyJhbGciOiJIUzI1NiJ9"
-→ {"alg":"HS256"}
-```
-
-### encode
-
-URL, HTML entity, or Unicode escape encoding/decoding.
-
-**Parameters:**
-- `input` (string) — String to encode or decode
-- `action` (enum) — `encode` or `decode`
-- `type` (enum) — `url`, `html`, or `unicode`
-
-**Examples:**
-```
-URL-encode "hello world"
-→ hello%20world
-
-HTML-decode "<script>"
-→ <script>
-```
-
-### regex
-
-Test, match, or replace with regular expressions.
-
-**Parameters:**
-- `pattern` (string) — Regular expression pattern
-- `flags` (string, optional) — Regex flags (g, i, m, etc.)
-- `text` (string) — Text to search
-- `action` (enum) — `match`, `test`, `replace`, or `matchAll`
-- `replacement` (string, optional) — Replacement string for replace
-
-**Examples:**
-```
-Extract numbers from "abc123def456"
-→ ["123", "456"]
-
-Replace all spaces with dashes in "hello world"
-→ "hello-world"
-```
-
-### diff
-
-Line diff or Levenshtein distance between two texts.
-
-**Parameters:**
-- `text1` (string) — First text
-- `text2` (string) — Second text
-- `action` (enum, optional) — `diff` (line diff, default) or `distance` (Levenshtein)
-
-**Examples:**
-```
-Edit distance: "kitten" → "sitting"
-→ 3
-
-Line diff between two texts
-→ - old line
-→ + new line
-```
-
-### char_info
-
-Get Unicode information about characters.
-
-**Parameters:**
-- `char` (string) — Character(s) to get info about
-
-**Examples:**
-```
-Unicode info for "€"
-→ U+20AC, Currency Symbols
-
-What's the code point for "🌍"?
-→ U+1F30D, Miscellaneous Symbols and Pictographs
-```
-
-## Validation & Parsing
-
-### json_validate
-
-Validate JSON, CSV, XML, or YAML format.
-
-**Parameters:**
-- `input` (string) — String to validate/parse
-- `format` (enum) — `json`, `csv`, `xml`, or `yaml`
-
-**Examples:**
-```
-Is '{"name":"test"}' valid JSON?
-→ valid, object, keys: ["name"]
-
-Validate CSV with 3 columns
-→ valid, 10 rows, 3 columns
-```
-
-### luhn
-
-Validate or generate Luhn check digits (credit cards, etc.).
-
-**Parameters:**
-- `number` (string) — Number string to validate or generate check digit for
-- `action` (enum, optional) — `validate` (default) or `generate`
-
-**Examples:**
-```
-Is 4539578763621486 a valid card number?
-→ true
-
-Generate check digit for 453957876362148
-→ 6
-```
-
-### semver
-
-Semantic versioning operations: compare, validate, or check range satisfaction.
-
-**Parameters:**
-- `action` (enum) — `compare`, `valid`, or `satisfies`
-- `version` (string) — Semver version string
-- `version2` (string, optional) — Second version for compare
-- `range` (string, optional) — Version range for satisfies (e.g., `^1.0.0`)
-
-**Examples:**
-```
-Does 1.5.3 satisfy ^1.0.0?
-→ true
-
-Compare 2.0.0 and 1.9.9
-→ 2.0.0 is greater
-```
-
-### ip
-
-IPv4/IPv6 address information, CIDR range calculations, and membership checks.
-
-**Parameters:**
-- `action` (enum) — `info`, `contains`, or `range`
-- `ip` (string, optional) — IP address
-- `cidr` (string, optional) — CIDR notation (e.g., `192.168.1.0/24`)
-- `target` (string, optional) — Target IP to check against CIDR
-
-**Examples:**
-```
-IP range of 192.168.1.0/24?
-→ 192.168.1.1 – .254 (254 hosts)
-
-Is 192.168.1.50 in 192.168.1.0/24?
-→ true
-```
-
-### color
-
-Convert between color formats: HEX ↔ RGB ↔ HSL.
-
-**Parameters:**
-- `color` (string) — Color value: `#hex`, `rgb(r,g,b)`, or `hsl(h,s%,l%)`
-- `to` (enum, optional) — `hex`, `rgb`, or `hsl` (returns all if omitted)
-
-**Examples:**
-```
-Convert #FF5733 to RGB
-→ rgb(255, 87, 51)
-
-Convert rgb(100, 200, 50) to HSL
-→ hsl(100, 60%, 49%)
-```
-
-### jwt_decode
-
-Decode JWT tokens (header + payload, no signature verification).
-
-**Parameters:**
-- `token` (string) — JWT token to decode
-
-**Examples:**
-```
-Decode this JWT: eyJhbGci...
-→ { header: { alg: "HS256" }, payload: { name: "John Doe" } }
-```
-
-### url_parse
-
-Parse URLs into components.
-
-**Parameters:**
-- `url` (string) — URL to parse
-
-**Examples:**
-```
-Parse https://example.com/search?q=hello
-→ host: example.com, pathname: /search, q: "hello"
-```
-
----
-
-## Tool Categories Summary
-
-| Category | Count | Tools |
-|----------|-------|-------|
-| Math & Numbers | 4 | math, count, base, convert |
-| Random | 1 | random (5 types) |
-| Date & Time | 3 | datetime, date, cron_parse |
-| Text Processing | 6 | hash, base64, encode, regex, diff, char_info |
-| Validation & Parsing | 7 | json_validate, luhn, semver, ip, color, jwt_decode, url_parse |
-
-**Total: 21 tools**