construction-alert-mcp

construction-alert-mcp

건설알림이 MCP server that lets users search Seoul city construction project lists and retrieve onsite photos via the Seoul Open Data API, with per-user API key isolation.

Category
Visit Server

README

건설알림이 MCP

서울시 건설공사(공사장) 알림 정보를 조회하는 MCP 서버.

상태

✅ fly.dev 배포 완료 — https://construction-alert-mcp-hlucent.fly.dev/mcp

진행 순서

  1. [x] 저장소 & 개발일지 세팅
  2. [x] 데이터소스 확정 & 인증키 발급
  3. [x] 로컬 스캐폴딩
  4. [x] 도구(tool) 설계 및 실제 API 호출 테스트
  5. [x] 테스트 & 배포 (fly.dev)
  6. [ ] PlayMCP 등록 & Claude 연동 테스트
  7. [ ] 개발일지 마무리

도구(tool) 목록

  • search_construction_projects — 서울시 건설알림이(One-PMIS) 공사장 목록을 자치구명/키워드로 검색 (사업명, 위치, 발주처/시공사, 착공일, 준공예정일, 도급액, 위경도 등 반환)
  • get_construction_project_photos — 사업코드(PJT_CD)로 공사현장 사진 목록 조회

출처 표기 필수: 두 도구 모두 결과 JSON에 출처 필드(서울 열린데이터광장 데이터셋명)를 포함하며, 이 MCP를 사용해 답변할 때는 반드시 그 출처를 답변에 명시해야 한다. 출처 생략은 금지된다.

실행 방법

로컬 실행

npm install
npm start

서버는 http://localhost:8080/mcp (Streamable HTTP transport)에서 요청을 받는다. 접속 시 반드시 ?key=본인의_서울열린데이터광장_인증키를 URL에 붙여야 한다 (아래 참고).

다른 사용자가 자기 API 키로 쓰는 방법

이 서버는 서버 공용 키를 공유하지 않는다. 각 사용자가 반드시 자신의 서울 열린데이터광장 인증키를 URL 쿼리 파라미터로 넣어야 동작하며, 요청별 키는 Node.js AsyncLocalStorage로 격리되어 여러 사용자가 동시에 접속해도 서로 섞이지 않는다.

  1. data.seoul.go.kr에서 회원가입 후 "인증키 관리" 메뉴에서 본인 인증키를 발급받는다.
  2. MCP 클라이언트 설정에서 이 서버에 연결할 때 URL에 ?key=본인키를 붙인다.
    https://construction-alert-mcp-hlucent.fly.dev/mcp?key=본인이_발급받은_인증키
  3. ?key=가 없으면 서버는 요청을 처리하지 않고 401과 함께 아래 안내를 반환한다.
    API 키가 필요합니다. ?key=본인의_서울열린데이터광장_인증키를 URL에 추가해주세요.

fly.dev 배포

flyctl deploy

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured