Skip to main content
Glama
VladimirBigunenko

mcp-utility-server

MCP 유틸리티 서버

일상 운영을 위한 10가지 유틸리티 도구를 갖춘 프로덕션 등급의 Model Context Protocol 서버입니다. FastMCP 기반, 표준 라이브러리 우선, 완전 테스트(TDD) 적용.

이 서버가 필요한 이유: hello-world가 아닌 실제 MCP 엔지니어링을 보여줍니다. 다음을 포함합니다:

  • 재시도/백오프 + 지터(jitter) — 모든 외부 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 파싱 → 마크다운 요약

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

stdio 또는 sse

예시: 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_convertFILE_SANDBOX가 설정되지 않으면 모든 경로를 허용합니다 — 프로덕션에서는 반드시 설정하세요

  • Telegram 토큰은 환경 변수에서만 읽으며 절대 로그에 기록하지 않습니다

  • antimatter_scan("docker:...")docker logs를 실행합니다 — docker 소켓 접근 권한 필요

라이선스

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