Skip to main content
Glama
VladimirBigunenko

mcp-utility-server

MCP Utility Server

Un servidor Model Context Protocol de grado de producción con 10 herramientas de utilidad para operaciones diarias. Construido con FastMCP, primero en stdlib, totalmente probado (TDD).

Por qué este servidor: demuestra ingeniería MCP real, no un hola mundo. Incluye:

  • Reintentos/backoff con jitter en todas las llamadas HTTP externas (manejo de 429/5xx)

  • Persistencia de estado para monitoreo de páginas (seguimiento de diff SHA-256)

  • Observabilidad — contadores de reintentos por herramienta expuestos como una herramienta MCP

  • Sandboxing para operaciones de archivos (opcional FILE_SANDBOX)

  • Salidas deterministas (la selección de palabra del día se basa en hash, igual todo el día)

  • ~30 pruebas pytest con red simulada (sin dependencias externas en CI)

Herramientas

Tool

Descripción

file_convert

Convertir formatos MD/HTML/CSV/JSON/Texto (solo stdlib)

page_monitor

Consultar una URL, diff SHA-256, notificación opcional de Telegram al cambiar

telegram_poll

Enviar encuestas de Telegram (2-10 opciones)

trade_signal

Binance OHLCV → RSI(14) + cruce SMA20/SMA50 → COMPRAR/VENDER/MANTENER

backtest_report

Analizar JSON de backtest de Freqtrade → resumen en markdown

word_of_day

Palabra alemana (A1/A2) con traducciones, IPA, ejemplos — determinista por fecha

soc_lang_card

Tarjeta de idioma diaria: palabra alemana + término SOC (EN/DE/RU)

weather_alert

Alertas de umbral de Open-Meteo (viento/lluvia) para ciudades configuradas

antimatter_scan

Escanear registros de trading en busca de operaciones/errores/señales + puntuación de resonancia

mcp_stats

Instantánea de observabilidad de reintentos/backoff

Related MCP server: Local Utilities MCP Server

Inicio rápido

# 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

Configuración (variables de entorno)

Env

Default

Propósito

TELEGRAM_BOT_TOKEN

Requerido para telegram_poll / notificación de page_monitor

TELEGRAM_CHAT_ID

Chat predeterminado para herramientas de Telegram

FILE_SANDBOX

sin configurar (permitir todo)

Restringir file_convert a un directorio. ¡Configúralo en producción!

STATE_DIR

~/.mcp-utility/state

Ubicación del estado del monitor de páginas

HTTP_MAX_RETRIES

2

Máximo de reintentos en 429/5xx (1 inicial + N reintentos)

HTTP_RETRY_DELAY

1.0

Segundos de backoff base (exponencial, ±20% de jitter)

MCP_STATS_PATH

/tmp/mcp_utility_stats.json

Persistencia de estadísticas de reintentos

MCP_LOG

INFO

Nivel de registro

MCP_TRANSPORT

stdio

stdio o sse

Ejemplo: Claude Desktop

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

Ejemplo: señal de trading

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"],...}

Notas de seguridad

  • file_convert acepta cualquier ruta cuando FILE_SANDBOX no está configurado — configúralo siempre en producción

  • El token de Telegram se lee solo desde el entorno, nunca se registra

  • antimatter_scan("docker:...") ejecuta docker logs — requiere acceso al socket de docker

Licencia

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