Skip to main content
Glama
pinnaclesoft-ko

Seoul Public Data MCP Server

by pinnaclesoft-ko
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote
README.md

# 서울 공공데이터 MCP 서버 예제

서울 공공데이터 API를 사용하여 서울시의 다양한 공공 데이터를 제공하는 MCP 서버 예제입니다. 

## 예제 목록

- 서울시 지하철호선별 역별 승하차 인원 정보
- 서울시 문화행사 정보 


## 설정방법

### 서울 공공데이터 API 키 설정

#### 서울시 지하철호선별 역별 승하차 인원 정보
파일 `modules/KoreaSeoulCulturalEventInfo.ts`에 다음 {API 키}를 추가한다.

```typescript
import {
    Tool,
} from "@modelcontextprotocol/sdk/types.js";

const API_URL = "http://openapi.seoul.go.kr:8088/{authKey}/json/culturalEventInfo/{StartIndex}/{EndIndex}";
const API_KEY = "{API 키}";
```

#### 서울시 문화행사 정보
파일 `modules/KoreaSeoulSubwayStatus.ts`에 다음 {API 키}를 추가한다.

```typescript
import {
    Tool,
} from "@modelcontextprotocol/sdk/types.js";

const API_URL = "http://openapi.seoul.go.kr:8088/{authKey}/json/culturalEventInfo/{StartIndex}/{EndIndex}";
const API_KEY = "{API 키}";
```

## 빌드하기

```bash
npm i; npm run build
```

#### Claude Desktop 에 MCP 설정 추가하기 
`claude_desktop_config.json` 파일에 다음을 추가한다.
{빌드된 경로}는 자신에 맞게 추가해야 함.

```json
{
  "mcpServers": {
    "KoreaSeoulData": {
      "command": "node",
      "args": [
        "{빌드된 경로}/seoul_korea/dist/index.js"
      ]
    }
  }
}
```


## 사용예제

### 서울시 지하철호선별 역별 승하차 인원 정보

![image](docs/images/ex_001.png)


### 서울시 문화행사 정보

![image](docs/images/ex_002.png)
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have completely distinct purposes with no overlap. CulturalEventInfo retrieves cultural event information from Seoul's cultural portal, while KoreaSeoulSubwayStatus provides subway station passenger count data. An agent can easily differentiate between these two unrelated domains.

Naming Consistency3/5

The naming is mixed with no consistent pattern. CulturalEventInfo uses a descriptive noun phrase format, while KoreaSeoulSubwayStatus follows a different descriptive naming style. Both are readable but lack a consistent verb_noun or other predictable convention across the set.

Tool Count2/5

With only 2 tools, this server feels severely under-scoped for what appears to be a general 'Seoul Public Data' server. The tools cover two specific data endpoints, but the server name suggests broader public data access that would typically require more comprehensive coverage of Seoul's public data APIs.

Completeness2/5

Given the server name 'Seoul Public Data MCP Server,' there are significant gaps in coverage. Seoul likely offers numerous public data APIs beyond just cultural events and subway passenger counts. The surface is severely incomplete for what the server name promises, with no coverage of transportation, weather, demographics, or other typical public data domains.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources