agentmods.dev

seoul-construction-mcp: Instructions file for Claude Code

CLAUDE.md

seoul-construction-mcp CLAUDE.md is an instructions file for Claude Code from hlucent/seoul-construction-mcp. It costs 4,632 tokens per session, scanned A, original, MIT.

Project instructions for a Node.js MCP server that searches Seoul construction data from South Korea’s open-data service. MCP lets an AI assistant use the project’s data-search tools through a standard connection.

In plain words
What is it for?
For maintaining the server and using its four documented tools to search construction projects, filter district work, check progress, and retrieve project photos.
Why use it?
They give the coding agent project-specific facts, file locations, deployment details, and rules for communicating with a non-developer. This helps prevent work on outdated copies or the wrong entry file.

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/seoul-construction-mcp's own configuration. It tells Claude Code how to work on seoul-construction-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 seoul-construction-mcp configures →

not rated 0repo changed 2mo ago A scan 4,632 tokens original MIT
View source ↗ hlucent/seoul-construction-mcp
Reuse

Borrowing it

Nothing to install: this file belongs to hlucent/seoul-construction-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/seoul-construction-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/hlucent/seoul-construction-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 seoul-construction-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hlucent/seoul-construction-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/hlucent/seoul-construction-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hlucent/seoul-construction-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/seoul-construction-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 seoul-construction-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hlucent/seoul-construction-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/hlucent/seoul-construction-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,632 This file is loaded in full into every session.
When invoked 4,632 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.04632 $0.04632
Opus 5.5 $0.01853 $0.01853
Sonnet 5.5 $0.00926 $0.00926
Haiku 4.5 $0.00463 $0.00463

Measured 2mo ago against content hash 324b542be267, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

seoul-construction-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 2mo 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 · 243 lines

How it starts

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

CLAUDE.md — 서울시 건설알림이 MCP 프로젝트

프로젝트 개요

서울시 열린데이터광장의 건설공사 관련 데이터를 MCP(Model Context Protocol) 서버로 제공하는 프로젝트. Claude Desktop/Code에 로컬로 등록해 자연어로 서울시 공사 현황을 검색/조회할 수 있게 해준다.

  • 배포 방식: 로컬 전용(stdio). 클라우드 서버나 URL이 없다 — 각자 이 저장소를 clone해 자기 컴퓨터에서 Claude가 직접 프로세스를 실행하는 방식이다. (과거 fly.io 웹 배포 버전은 2026-09-03에 완전히 삭제됐고, 2026-09-08에 stdio 구조로 전환하며 관련 코드/설정도 모두 제거함. 배경은 DEVLOG.md "2026-09-07~08" 항목 참고.)
  • GitHub: hlucent/seoul-construction-mcp
  • 실제 작업 폴더(확정): C:\Users<집PC계정명>\Projects\seoul-construction-mcp (집 PC) / C:\Users<사무실PC계정명>\Projects\seoul-construction-mcp (사무실 PC) (.git 존재, origin이 github.com/hlucent/seoul-construction-mcp로 연결됨, 최신 커밋과 코드가 일치하는 진짜 작업 폴더)
  • 실제 코드 진입점: src/index.js (Node.js 프로젝트, 단일 파일. main.py 아님)
  • 참고: 과거 저장소명은 construction-alert-mcp였으나 이후 seoul-construction-mcp로 개편됨(package.json의 name, index.js의 serverInfo.name 모두 통일 완료). 앞으로 이 프로젝트 작업은 반드시 위 Projects 폴더에서만 진행할 것.
  • 사용자(청정)는 비개발자 — 모든 안내는 복사-붙여넣기 가능한 완성된 명령어로, 어느 창(PowerShell/메모장/브라우저)에 입력하는지 명확히 구분해서 제공할 것.

현재 제공 중인 도구 (4개)

  1. search_construction_projects — 사업개요 검색 (OA-15585), 자치구/키워드/도급액 필터
    • 발주처_연락처/건설사업관리단_연락처/시공사_연락처(TEL_1~3) 필드 포함
  2. search_construction_work_by_district — 자치구별 공사 정보 검색 (OA-1222)
  3. get_construction_progress — 공정률/기성률/D-Day 등 진행 현황. 공정률/대비율이 0이면 "미입력"으로 표시(formatRate 헬퍼). min_amount(도급액 기준) 클라이언트단 필터 지원. API 자체 필터는 없음.
  4. get_construction_project_photos — 사업코드(pjt_cd)로 현장 사진 목록 조회 (OA-15586)
    • 모든 사업에 사진이 있는 건 아님 (소규모/단기 사업은 사진 없는 경우 많음)
    • 대형 장기사업(예: 강남순환도시고속도로)은 주기적으로 사진 업데이트됨

아키텍처 핵심 사항

  • stdio 전송 방식: StdioServerTransport 사용. Claude Desktop/Code가 node 프로세스를 직접 실행해 stdin/stdout으로 통신한다. HTTP 서버, express, 인증 (?key=), rate limit, 별도 프록시(mcp-remote 등)가 전부 없다 — 이 프로세스 자체가 실행하는 컴퓨터 안에서만 동작하므로 외부에서 접근할 방법이 없어 인증이 불필요하다.
  • SEOUL_OPENAPI_KEY(서울시 업스트림 API 호출용)만 필요한 유일한 키. Claude Desktop/Code 설정 파일의 env 항목에 직접 넣거나, 로컬 수동 테스트 시에는 .env 파일로 넣는다(dotenv/config로 로드).
  • CDATA XML 파싱 이슈 수정 완료
  • Dockerfile, deploy.ps1(과거 fly.io 배포용)은 2026-09-08 stdio 전환 시 저장소에서 삭제함(git 히스토리에는 남아있음).
  • 참고: 로컬 실행 시 필요한 유일한 npm 스크립트는 npm start(=node src/index.js).
  • Claude Desktop 등록 시 주의점 (실제로 겪은 트러블, DEVLOG 2026-09-07~08 참고):
    • Microsoft Store(MSIX) 버전은 %APPDATA%\Claude\claude_desktop_config.json이 아니라 %LOCALAPPDATA%\Packages\Claude_<임의문자열>\LocalCache\Roaming\Claude\claude_desktop_config.json이 실제 설정 파일이다. 겉보기 표준 경로를 아무리 고쳐도 반영 안 되면 이 경로부터 확인할 것.
    • "command": "node"보다 "command"를 node.exe 전체 경로(예: C:\\Program Files\\nodejs\\node.exe, PowerShell의 (Get-Command node).Source로 확인)로 지정하는 쪽이 더 안정적으로 연결됨.

Read the full file on GitHub · 243 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. 2mo ago Changed · -35 lines · -555 tokens per session 324b542be267
  2. 2mo ago Changed · +1 lines · +9 tokens per session 396f50e70f5d
  3. 2mo ago First seen · 277 lines · 5,178 tokens per session scan A 0ccc4745dc25

Subscribe to this mod's changes

seoul-construction-mcp CLAUDE.md is an instructions file published in the GitHub repository hlucent/seoul-construction-mcp (0 stars, last pushed 2mo ago), licensed MIT. It adds 4,632 tokens to every session, about $0.0185 per session on Opus 5.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.

Research
Related

seoul-construction-mcp CLAUDE.md compared with instructions from other repositories

seoul-construction-mcp CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
seoul-construction-mcp CLAUDE.mdhlucent/seoul-construction-mcpInstructions file02mo agoMITA4,632Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode