Skip to main content
Glama
VladimirBigunenko

mcp-utility-server

MCP Utility Server

A production-grade Model Context Protocol server with 10 utility tools for daily operations. Built with FastMCP, stdlib-first, fully tested (TDD).

Why this server: it demonstrates real MCP engineering — not a hello-world. It includes:

  • Retry/backoff with jitter on all external HTTP calls (429/5xx handling)

  • State persistence for page monitoring (SHA-256 diff tracking)

  • Observability — per-tool retry counters exposed as an MCP tool

  • Sandboxing for file operations (optional FILE_SANDBOX)

  • Deterministic outputs (word-of-day selection is hash-based, same all day)

  • ~30 pytest tests with mocked network (no external deps in CI)

Tools

Tool

Description

file_convert

Convert MD/HTML/CSV/JSON/Text formats (stdlib-only)

page_monitor

Poll a URL, SHA-256 diff, optional Telegram notify on change

telegram_poll

Send Telegram polls (2-10 options)

trade_signal

Binance OHLCV → RSI(14) + SMA20/SMA50 cross → BUY/SELL/HOLD

backtest_report

Parse Freqtrade backtest JSON → markdown digest

word_of_day

German word (A1/A2) with translations, IPA, examples — deterministic per date

soc_lang_card

Daily language card: German word + SOC term (EN/DE/RU)

weather_alert

Open-Meteo threshold alerts (wind/rain) for configured cities

antimatter_scan

Scan trading logs for trades/errors/signals + resonance score

mcp_stats

Retry/backoff observability snapshot

Related MCP server: Local Utilities MCP Server

Quick start

# Install
uv sync

# Run (stdio transport — default for MCP clients)
uv run server.py

# Run (SSE transport — for remote clients)
uv run server.py --transport sse

# Test
uv run pytest

Configuration (env vars)

Env

Default

Purpose

TELEGRAM_BOT_TOKEN

Required for telegram_poll / page_monitor notify

TELEGRAM_CHAT_ID

Default chat for Telegram tools

FILE_SANDBOX

unset (allow-all)

Restrict file_convert to a directory. Set on production!

STATE_DIR

~/.mcp-utility/state

Page-monitor state location

HTTP_MAX_RETRIES

2

Max retries on 429/5xx (1 initial + N retries)

HTTP_RETRY_DELAY

1.0

Base backoff seconds (exponential, ±20% jitter)

MCP_STATS_PATH

/tmp/mcp_utility_stats.json

Retry stats persistence

MCP_LOG

INFO

Logging level

MCP_TRANSPORT

stdio

stdio or sse

Example: Claude Desktop

{
  "mcpServers": {
    "mcp-utility": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-utility-server", "server.py"]
    }
  }
}

Example: trade signal

echo '{"symbol":"BTCUSDT","interval":"1d"}' | uv run server.py
# → {"status":"ok","symbol":"BTCUSDT","rsi":42.3,"ma_fast":42100.0,
#    "ma_slow":41800.5,"signal":"BUY","reasons":["MA20 > MA50"],...}

Security notes

  • file_convert accepts any path when FILE_SANDBOX is unset — always set it in production

  • Telegram token is read from env only, never logged

  • antimatter_scan("docker:...") executes docker logs — requires docker socket access

License

MIT

F
license - not found
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A lightweight, modular API service that provides useful tools like weather, date/time, calculator, search, email, and task management through a RESTful interface, designed for integration with AI agents and automated workflows.
    5
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides essential utility tools for text processing, file operations, hashing, temperature conversion, password generation, and date/time operations through a comprehensive MCP interface.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive collection of 103 tools providing capabilities for text processing, data analysis, web development, and business management in a single server. It is designed for rapid deployment to Vercel and integrates seamlessly with MCP clients like Claude and Cursor to automate diverse workflows.
    29
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Swiss-army-knife utility MCP server for AI agents. 18 tools for JSON validation/formatting, base64 encode/decode, hash generation, UUID generation, URL parsing, regex testing, markdown↔HTML conversion, text stats, slug generation, datetime conversion, cron parsing, text diffing, CSV↔JSON conversion, and JWT decoding. Zero API Key required
    5

View all related MCP servers

Related MCP Connectors

  • Deterministic AI agent microtools, no accounts/API keys. fetch_extract: 98% token cut. 38 tools.

  • Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API

  • 500+ deterministic tools for AI agents: math, conversion, validation, hashing, encoding, date/time.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VladimirBigunenko/mcp-utility-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server