KOBIS MCP Server
README.md
# π¬ KOBIS MCP Server
[μνμ§ν₯μμν μνκ΄μ
μ₯κΆ ν΅ν©μ μ°λ§(KOBIS) μ€νAPI](https://www.kobis.or.kr/kobisopenapi)λ₯Ό Claude κ°μ AI λꡬμμ μΈ μ μκ² ν΄μ£Όλ **MCP μλ²**μ
λλ€.
μ°κ²°νλ©΄ AIμκ² μ΄λ κ² λ¬Όμ΄λ³Ό μ μμ΅λλ€.
- "μ΄μ λ°μ€μ€νΌμ€ 1~10μ μλ €μ€"
- "μ§λ μ£Όλ§ νκ΅ μν μμλ§ λ³΄μ¬μ€"
- "λ΄μ€νΈ κ°λ
μν λͺ©λ‘μ΄λ κ° μν κ΄λλ±κΈ μ 리ν΄μ€"
- "'μμΈμ λ΄' μΆμ° λ°°μ°μ μμμκ° μλ €μ€"
> **API ν€λ μ΄ μ½λμ λ€μ΄μμ§ μμ΅λλ€.** κ°μ λ°κΈλ°μ ν€λ₯Ό λ΄ μ»΄ν¨ν° μ€μ μ λ£μ΄μ μ¬μ©ν©λλ€.
---
## 1. API ν€ λ°κΈλ°κΈ° (무λ£)
1. [KOBIS μ€νAPI](https://www.kobis.or.kr/kobisopenapi) μ μ ν νμκ°μ
λ° λ‘κ·ΈμΈ
2. μλ¨ λ©λ΄ **ν€ λ°κΈ/κ΄λ¦¬** β **ν€ λ°κΈ**
3. λ°κΈλ ν€(μλ¬Έ+μ«μ 32μ리)λ₯Ό 볡μ¬ν΄ λ‘λλ€.
## 2. μ€μΉ λ° μ°κ²°
[Node.js](https://nodejs.org) 18 μ΄μμ΄ νμν©λλ€. ν°λ―Έλμμ `node -v`λ‘ νμΈν μ μμ΅λλ€.
λ°λ‘ λ΄λ €λ°μ νμ μμ΄, μλ μ€μ λ§ λ£μΌλ©΄ GitHubμμ μλμΌλ‘ λ°μ μ€νλ©λλ€.
### Claude Desktop
`μ€μ β κ°λ°μ β κ΅¬μ± νΈμ§`μ λλ¬ `claude_desktop_config.json`μ μ΄κ³ μλ λ΄μ©μ μΆκ°ν©λλ€.
```json
{
"mcpServers": {
"kobis": {
"command": "npx",
"args": ["-y", "github:cocossi381-cell/kobis-mcp"],
"env": {
"KOBIS_API_KEY": "μ¬κΈ°μ_λ°κΈλ°μ_ν€"
}
}
}
}
```
μ μ₯ν λ€ Claude Desktopμ μμ ν μ’
λ£νλ€κ° λ€μ μ€ννμΈμ.
### Claude Code
```bash
claude mcp add kobis -e KOBIS_API_KEY=μ¬κΈ°μ_λ°κΈλ°μ_ν€ -- npx -y github:cocossi381-cell/kobis-mcp
```
### μ§μ λ΄λ €λ°μ μ°κΈ° (.env λ°©μ)
```bash
git clone https://github.com/cocossi381-cell/kobis-mcp.git
cd kobis-mcp
npm install
cp .env.example .env # .env νμΌμ μ΄μ΄ KOBIS_API_KEY= λ€μ ν€ μ
λ ₯
```
μ΄ κ²½μ° MCP μ€μ μ λ€μκ³Ό κ°μ΅λλ€. κ²½λ‘λ λ΄λ €λ°μ μμΉλ‘ λ°κΏμ£ΌμΈμ.
```json
{
"mcpServers": {
"kobis": {
"command": "node",
"args": ["/λ΄/ν΄λ/κ²½λ‘/kobis-mcp/index.js"]
}
}
}
```
> `.env` νμΌμ `.gitignore`μ ν¬ν¨λμ΄ μμ΄ GitHubμ μ¬λΌκ°μ§ μμ΅λλ€. ν€λ μ λ κ³΅κ° μ μ₯μμ μ¬λ¦¬μ§ λ§μΈμ.
---
## 3. μ 곡 λꡬ
| λꡬ | μ€λͺ
| μ£Όμ μ
λ ₯κ° |
|---|---|---|
| `get_daily_boxoffice` | μΌλ³ λ°μ€μ€νΌμ€ (μ΅λ 10μ) | `targetDt` (YYYYMMDD, μλ΅ μ μ΄μ ), `repNationCd` (K νκ΅ / F μΈκ΅), `multiMovieYn` |
| `get_weekly_boxoffice` | μ£Όκ°Β·μ£Όλ§Β·μ£Όμ€ λ°μ€μ€νΌμ€ | `targetDt`, `weekGb` (0 μ£Όκ° / 1 μ£Όλ§ / 2 μ£Όμ€) |
| `search_movies` | μν λͺ©λ‘ κ²μ | `movieNm`, `directorNm`, `openStartDt`, `openEndDt` |
| `get_movie_info` | μν μμΈμ 보 (κ°λ
, λ°°μ°, μ₯λ₯΄, λ±κΈ, μμμκ°) | `movieCd` |
| `search_companies` | μνμ¬ κ²μ | `companyNm`, `ceoNm` |
| `get_company_info` | μνμ¬ μμΈμ 보 | `companyCd` |
| `search_people` | μνμΈ(λ°°μ°Β·κ°λ
λ±) κ²μ | `peopleNm`, `filmoNames` |
| `get_people_info` | μνμΈ μμΈμ 보 (νλͺ¨κ·ΈλνΌ) | `peopleCd` |
| `get_codes` | 곡ν΅μ½λ μ‘°ν | `comCode` (2201 μ₯λ₯΄, 2204 κ΅μ , 2601 μνμ¬ λΆλ₯ λ±) |
μ°Έκ³ : λ°μ€μ€νΌμ€λ **μ΄μ λ μ§κΉμ§λ§** μ§κ³λ©λλ€. μ€λ λ μ§λ‘ μ‘°ννλ©΄ κ²°κ³Όκ° λΉμ΄ μμ΅λλ€.
---
## 4. λ¬Έμ ν΄κ²°
| μ¦μ | ν΄κ²° λ°©λ² |
|---|---|
| `KOBIS_API_KEYκ° μ€μ λμ§ μμμ΅λλ€` | μ€μ μ `env`μ ν€λ₯Ό λ£μλμ§, λλ `.env` νμΌμ΄ μλμ§ νμΈνμΈμ. |
| `μ ν¨νμ§μμ ν€κ°μ
λλ€` | ν€λ₯Ό μλͺ» 볡μ¬νκ±°λ μλ€μ κ³΅λ°±μ΄ λ€μ΄κ°μ μ μμ΅λλ€. |
| Claudeμ λκ΅¬κ° μ 보μ | μ±μ μμ ν μ’
λ£ ν μ¬μ€ννμΈμ. `node -v`λ‘ Node.js μ€μΉ μ¬λΆλ νμΈνμΈμ. |
| μΌμΌ νΈμΆ μ ν μ΄κ³Ό | KOBIS μ€νAPIλ ν€λΉ ν루 νΈμΆ νμ μ νμ΄ μμ΅λλ€. λ€μ λ λ€μ μλνμΈμ. |
## 5. μ§μ ν
μ€νΈν΄λ³΄κΈ° (κ°λ°μμ©)
```bash
KOBIS_API_KEY=λ°κΈλ°μν€ npx @modelcontextprotocol/inspector node index.js
```
λΈλΌμ°μ μ MCP Inspectorκ° μ΄λ¦¬λ©΄ κ° λꡬλ₯Ό μ§μ μ€νν΄ λ³Ό μ μμ΅λλ€.
---
## λ°μ΄ν° μΆμ² λ° λΌμ΄μ μ€
- λ°μ΄ν°: [μνμ§ν₯μμν KOBIS μ€νAPI](https://www.kobis.or.kr/kobisopenapi). λ°μ΄ν° μ΄μ© μ μΆμ²λ₯Ό νκΈ°ν΄μ£ΌμΈμ.
- μ½λ: MIT License
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessOutdated data