agentmods.dev

safemap-uv-index-mcp: Instructions file for Claude Code

CLAUDE.md

safemap-uv-index-mcp CLAUDE.md is an instructions file for Claude Code from hlucent/safemap-uv-index-mcp. It costs 2,232 tokens per session, scanned A, original, MIT.

Project-specific instructions for building and testing a server that provides ultraviolet-index data. They describe which project files to read first, what to measure locally, and which deployment commands not to run.

In plain words
What is it for?
Use them when implementing the safemap UV-index MCP project, validating its API responses and data formats, recording uncertainties, and preparing a local build for deployment.
Why use it?
They prevent undocumented assumptions, repeated failed attempts, and accidental deployment while the API behavior is still being checked.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions CLAUDE.md; mentions Claude Code.

This is hlucent/safemap-uv-index-mcp's own configuration. It tells Claude Code how to work on safemap-uv-index-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything safemap-uv-index-mcp configures →

not rated 0repo 18d ago A scan 2,232 tokens original MIT
View source ↗ hlucent/safemap-uv-index-mcp
Reuse

Borrowing it

Nothing to install: this file belongs to hlucent/safemap-uv-index-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/hlucent/safemap-uv-index-mcp/master/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/hlucent/safemap-uv-index-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for safemap-uv-index-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hlucent/safemap-uv-index-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/hlucent/safemap-uv-index-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hlucent/safemap-uv-index-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/safemap-uv-index-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for safemap-uv-index-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hlucent/safemap-uv-index-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/safemap-uv-index-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,232 This file is loaded in full into every session.
When invoked 2,232 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.02232 $0.02232
Opus 5 $0.01116 $0.01116
Sonnet 5 $0.00446 $0.00446
Haiku 4.5 $0.00223 $0.00223

Measured 10d ago against content hash 1a9567f29c82, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

safemap-uv-index-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 152 lines

How it starts

The opening of the file, as written. The whole thing — 152 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md — safemap-uv-index-mcp (Claude Code 실행 지침)

0. 절대 규칙

  • DEVPLAN.md 하나만 먼저 읽고 시작한다. 다른 문서 재탐색 금지.
  • 웹서치 금지 (API 스펙은 DEVPLAN.md에 이미 있음).
  • 불확실하면 추측성 재설계 대신 기본값 1개로 구현 후 DEVLOG.md에 "확인 필요"로 기록한다.
  • 동일 오류 최대 3회까지만 재시도. 3회 실패 시 기록하고 사용자에게 보고한다.
  • 네 역할은 "코드 구현 + 로컬 실측 테스트"까지다. fly launch, fly secrets set, flyctl deploy, fly logs 등 fly.io 관련 명령은 절대 스스로 실행하지 않는다.
  • 배포 준비(코드 구현, 로컬 테스트, git commit/push)가 끝나면 아래 "작업 순서"의 마지막 단계에서 멈추고, "정지 안내 문구"를 그대로 출력한다.

1. 이 프로젝트 특유의 주의사항 (반드시 먼저 읽을 것)

이 프로젝트는 명세서가 엑셀/XML 샘플이 아니라 웹페이지 화면 캡처 2장 + 자바 샘플코드로만 제공되었다. 그래서 DEVPLAN.md 1절에 "실측 필요" 항목이 5개 있고, 이 항목들을 실측 단계에서 반드시 순서대로 검증해야 한다:

  1. returnType 기본값: 안내문은 "Default: JSON"이지만 자바 샘플은 returnType=xml을 명시. 매 요청에 returnType=json을 명시적으로 넣어서 호출하는 것으로 구현하고, 실제로 JSON이 오는지 1차 확인한다.
  2. 지역 필터 파라미터 부재: 요청 파라미터가 serviceKey/numOfRows/pageNo/returnType 4개뿐이라 지역(시도/시군구)으로 서버 사이드 필터링하는 파라미터가 안 보인다. 전국 데이터를 페이징으로만 순회하는 구조일 가능성이 높다. numOfRows를 크게(예: 1000) 주고 pageNo=1로 호출해 totalCount와 실제 반환 건수를 확인하고, 전국 시군구 수와 대략 맞는지 본다. 맞으면 서버 코드에서 전체 조회 → 클라이언트 사이드 필터링 방식으로 구현한다.
  3. 자외선지수(ulvry_index) 값의 실제 형태: STRING 타입인데 숫자인지 "낮음/보통/높음" 같은 등급 문자열인지 실측해서 README.md에 실제 형태를 기록한다.
  4. 발생일시(occrrnc_dt) 포맷: YYYYMMDDHHMM 등 실제 포맷을 실측 확인한다.
  5. 에러코드 체계: 정상 응답의 resultCode/resultMsg 실제 값을 먼저 확인하고, 마지막에 1회 정도 잘못된 키로 호출해 오류 시 resultCode/resultMsg 값을 확인한다(다른 정상 테스트를 방해하지 않도록 맨 마지막에 시도).

이 5개 항목의 검증 결과는 반드시 DEVLOG.md에 "무엇을 시도했고 무엇이 확인됐는지" 기록하고, README.md의 "알려진 제약사항"에도 실제 동작 기준으로 반영한다.

2. 기술적으로 반드시 적용할 것

2-1. .env

BOM 없는 UTF-8로 저장한다. 환경변수명은 SAFEMAP_API_KEY.

2-2. server.py의 mcp.run()

항상 stateless_http=True 포함:

mcp.run(transport="streamable-http", host="0.0.0.0", port=port, stateless_http=True)

2-3. 응답 파싱은 JSON 우선, XML 폴백 필수

이 API는 특히 returnType 처리가 명세서상 모호하므로(위 1절 항목 1), JSON 파싱 실패 시 XML <resultCode>/<resultMsg> 또는 <CODE>/<MESSAGE> 패턴을 정규식으로 파싱하는 폴백을 반드시 구현한다. safemap.go.kr의 실제 XML 루트/태그 구조는 실측하면서 확정한다.

Read the full file on GitHub · 152 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 152 lines · 2,232 tokens per session scan A 1a9567f29c82

Subscribe to this mod's changes

safemap-uv-index-mcp CLAUDE.md is an instructions file published in the GitHub repository hlucent/safemap-uv-index-mcp (0 stars, last pushed 18d ago), licensed MIT. It adds 2,232 tokens to every session, about $0.0112 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens