Skip to main content
Glama
VladimirBigunenko

mcp-utility-server

MCP Utility Server

一个生产级的 Model Context Protocol 服务器,提供 10 个实用工具 用于日常操作。基于 FastMCP 构建,标准库优先,全面测试(TDD)。

为什么选择这个服务器: 它展示了真正的 MCP 工程实践——而非 hello-world 示例。包括:

  • 带抖动的重试/退避 应用于所有外部 HTTP 调用(429/5xx 处理)

  • 状态持久化 用于页面监控(SHA-256 差异跟踪)

  • 可观测性 —— 每个工具的重试计数器以 MCP 工具形式暴露

  • 沙箱 用于文件操作(可选 FILE_SANDBOX

  • 确定性输出(每日单词选择基于哈希,全天一致)

  • ~30 个 pytest 测试 使用模拟网络(CI 中无外部依赖)

工具

工具

描述

file_convert

转换 MD/HTML/CSV/JSON/Text 格式(仅使用标准库)

page_monitor

轮询 URL,SHA-256 差异检测,变更时可选择 Telegram 通知

telegram_poll

发送 Telegram 投票(2-10 个选项)

trade_signal

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

backtest_report

解析 Freqtrade 回测 JSON → Markdown 摘要

word_of_day

德语单词(A1/A2)含翻译、IPA、示例——按日期确定性生成

soc_lang_card

每日语言卡片:德语单词 + SOC 术语(EN/DE/RU)

weather_alert

针对已配置城市的 Open-Meteo 阈值告警(风/雨)

antimatter_scan

扫描交易日志中的交易/错误/信号 + 共振评分

mcp_stats

重试/退避可观测性快照

Related MCP server: Local Utilities MCP Server

快速开始

# 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

配置(环境变量)

环境变量

默认值

用途

TELEGRAM_BOT_TOKEN

telegram_poll / page_monitor 通知所需

TELEGRAM_CHAT_ID

Telegram 工具的默认聊天

FILE_SANDBOX

未设置(允许全部)

file_convert 限制在某个目录内。生产环境务必设置!

STATE_DIR

~/.mcp-utility/state

页面监控状态存储位置

HTTP_MAX_RETRIES

2

429/5xx 最大重试次数(1 次初始 + N 次重试)

HTTP_RETRY_DELAY

1.0

基础退避秒数(指数退避,±20% 抖动)

MCP_STATS_PATH

/tmp/mcp_utility_stats.json

重试统计持久化

MCP_LOG

INFO

日志级别

MCP_TRANSPORT

stdio

stdiosse

示例:Claude Desktop

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

示例:交易信号

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

安全说明

  • 当未设置 FILE_SANDBOX 时,file_convert 接受任意路径——生产环境务必设置

  • Telegram 令牌仅从环境变量读取,绝不记录日志

  • antimatter_scan("docker:...") 执行 docker logs——需要 docker socket 访问权限

许可证

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