goldbean-utils

v1.0.0

Published

a month ago

🫘 10 practical MCP utility tools — JSON, date, hash, crypto, text, regex, color, CSV, diff, file. Standalone, zero dependencies, MIT open source.

0High
0Medium
0Low

wuzenghai

mcp modelcontextprotocol goldbean x402 utilities json hash crypto datetime regex color csv diff developer-tools ai-tools claude claude-desktop

🫘 GoldBean Utils

10 Practical MCP Utility Tools — JSON, Date, Hash, Crypto, Text, Regex, Color, CSV, Diff, File

Zero dependencies. Standalone. MIT open source.

GoldBean Utils gives AI assistants 10 essential dev tools that work without any API keys, subscriptions, or network calls. Install once, use everywhere.

Quick Start

npx goldbean-utils

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "goldbean-utils": {
      "command": "npx",
      "args": ["-y", "goldbean-utils"]
    }
  }
}

Tools

| # | Tool | Actions | What it does | |:-|:----|:-------|:-------------| | 1 | json_tool | format, validate, minify, query, diff, to_yaml | Format/validate JSON, JSONPath query, deep diff, YAML convert | | 2 | hash_tool | md5, sha1, sha256, sha512 | Hash text/files, HMAC signing | | 3 | datetime_tool | now, timestamp, convert_tz, add, diff, format | Timezone conversion, date math, relative time | | 4 | crypto_tool | validate_address, checksum_eth, detect_chain, random_hex, sha3 | ETH/BTC/SOL address validation, EIP-55 checksum | | 5 | text_tool | base64_encode, base64_decode, uuid, slugify, count, detect_encoding, truncate | Base64, UUID generation, encoding detection | | 6 | regex_tool | test, match, replace, split, explain | Test patterns, extract matches, explain regex | | 7 | color_tool | convert, palette, contrast, random, blend | Hex/RGB/HSL conversion, WCAG contrast, palette generation | | 8 | csv_tool | parse, to_json, filter, sort, stats, head, search | CSV parse/query, statistics, JSON export | | 9 | diff_tool | lines, unified, stats, words | Line-by-line diff, unified format, word diff | | 10 | file_tool | list, info, search, tree | Directory listing, file info, text search, file tree |

Examples

JSON Format & Query

> json_tool with action="format", json='{"user":{"name":"Alice","age":30}}'
{
  "user": {
    "name": "Alice",
    "age": 30
  }
}

Regex Testing

> regex_tool with action="match", pattern="\\b[A-Z][a-z]+\\b", text="Hello World from GoldBean"
[0] "Hello" (index: 0)
[1] "World" (index: 6)
[2] "GoldBean" (index: 17)
Total: 3 match(es)

Wallet Validation

> crypto_tool with action="validate_address", address="0x7484b0bca25d2ee56e9b0535572d4cf44a047d98"
ETH: ✅ Valid (0x + 40 hex chars)
BTC: ❌ Invalid (Base58 or Bech32)
SOL: ❌ Invalid (Base58, 32-44 chars)

Color Contrast Check

> color_tool with action="contrast", color="#000000", color2="#FFFFFF"
Contrast Ratio: 21.00:1
WCAG AA (normal text): ✅ Pass
WCAG AAA (normal text): ✅ Pass

Why GoldBean Utils?

AI assistants are great at many things, but they struggle with:

JSON formatting — inconsistent indentation, invalid output
Date math — timezone confusion, DST errors
Regex — hallucinated patterns that don't work
Hash/checksum — cannot compute locally

GoldBean Utils gives your AI assistant real, verifiable tools for these tasks.

Ecosystem

GoldBean Utils is part of the GoldBean ecosystem:

goldbean-mcp — 120+ paid APIs for AI agents via x402 micropayments
goldbean-utils — (this package) Free, standalone utility tools
GoldBean API — https://goldbean-api.xyz