README.md•1.27 kB
# NEIS MCP
## Overview
**NEIS MCP** exposes a Model Control Protocol (MCP) endpoint for Korean school data from the [NEIS OpenAPI](https://open.neis.go.kr).
It provides access to meals, timetables, and school information through a single standardized API.
## Setup
### 1. Get a NEIS OpenAPI Key
1. Log in to NEIS OpenAPI:
[https://open.neis.go.kr/portal/user/oauth/authorizePage.do](https://open.neis.go.kr/portal/user/oauth/authorizePage.do)
2. After logging in, go to **마이페이지 → 인증키 발급**:
[https://open.neis.go.kr/portal/myPage/actKeyPage.do](https://open.neis.go.kr/portal/myPage/actKeyPage.do)
3. Apply for an API key for the data services you need (e.g., 급식정보, 시간표, 학사일정).
4. Copy your issued **인증키 (API Key)**.
### 2. Deploy on Render
1. Push your repository to GitHub.
2. On [Render](https://render.com):
- Create a **Web Service**.
- Connect your repository.
- Add an environment variable:
```
NEIS_API_KEY=your_api_key_here
```
- Deploy the service.
### 3. Verify Endpoint
After deployment, access:
```
https://your.domain/mcp
```
to confirm the MCP endpoint is running.
## Usage with MCP Client
Connect your endpoint to an MCP-compatible client such as Claude Desktop or Poke.