naver-data-mcp-server

naver-data-mcp-server

3.1

If you are the rightful owner of naver-data-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project provides a server that offers the Naver Data Lab API through a Model Context Protocol (MCP) interface.

๋„ค์ด๋ฒ„ ๋ฐ์ดํ„ฐ๋žฉ MCP ์„œ๋ฒ„

์ด ํ”„๋กœ์ ํŠธ๋Š” ๋„ค์ด๋ฒ„ ๋ฐ์ดํ„ฐ๋žฉ API๋ฅผ Model Context Protocol(MCP) ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ œ๊ณตํ•˜๋Š” ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

๊ธฐ๋Šฅ

๊ฒ€์ƒ‰์–ด ํŠธ๋ Œ๋“œ

  • ๋„ค์ด๋ฒ„ ๋ฐ์ดํ„ฐ๋žฉ ํ†ตํ•ฉ ๊ฒ€์ƒ‰์–ด ํŠธ๋ Œ๋“œ API ์ œ๊ณต
  • ๊ฒ€์ƒ‰์–ด ๊ทธ๋ฃน๋ณ„ ํŠธ๋ Œ๋“œ ์กฐํšŒ (์ตœ๋Œ€ 5๊ฐœ ๊ทธ๋ฃน, ๊ทธ๋ฃน๋‹น ์ตœ๋Œ€ 5๊ฐœ ๊ฒ€์ƒ‰์–ด)
  • ๊ธฐ๊ฐ„, ์„ฑ๋ณ„, ์—ฐ๋ น๋Œ€, ๋””๋ฐ”์ด์Šค ๊ธฐ์ค€ ํ•„ํ„ฐ๋ง ์ง€์›

์‡ผํ•‘์ธ์‚ฌ์ดํŠธ

  • ์‡ผํ•‘ ๋ถ„์•ผ๋ณ„ ํŠธ๋ Œ๋“œ ์กฐํšŒ ๊ธฐ๋Šฅ (์ตœ๋Œ€ 3๊ฐœ ๋ถ„์•ผ)
  • ํŠน์ • ์‡ผํ•‘ ๋ถ„์•ผ ๋‚ด ํ‚ค์›Œ๋“œ๋ณ„ ํŠธ๋ Œ๋“œ ์กฐํšŒ ๊ธฐ๋Šฅ (์ตœ๋Œ€ 3๊ฐœ ํ‚ค์›Œ๋“œ)
  • ๊ธฐ๊ฐ„, ์„ฑ๋ณ„, ์—ฐ๋ น๋Œ€, ๋””๋ฐ”์ด์Šค ๊ธฐ์ค€ ํ•„ํ„ฐ๋ง ์ง€์›

์„ค์น˜

npm์„ ํ†ตํ•œ ์„ค์น˜

npm install -g naver-datalab-mcp-server

์†Œ์Šค์ฝ”๋“œ๋กœ ์„ค์น˜

# ์ €์žฅ์†Œ ํด๋ก 
git clone https://github.com/sonhyeonho/naver-data-lab-mcp-server.git
cd naver-data-lab-mcp-server

# ์˜์กด์„ฑ ์„ค์น˜ ๋ฐ ๋นŒ๋“œ
npm install
npm run build

๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •

ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •

.env ํŒŒ์ผ์„ ์ƒ์„ฑํ•˜๊ณ  ๋‹ค์Œ ๋‚ด์šฉ์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

# .env.example ํŒŒ์ผ์„ ๋ณต์‚ฌํ•˜์—ฌ .env ํŒŒ์ผ ์ƒ์„ฑ
cp .env.example .env

# .env ํŒŒ์ผ์„ ์—ด๊ณ  ๋‹ค์Œ ๋‚ด์šฉ์„ ์ˆ˜์ •
NAVER_CLIENT_ID=your_naver_client_id_here
NAVER_CLIENT_SECRET=your_naver_client_secret_here

๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰

# ๊ฐœ๋ฐœ ๋ชจ๋“œ๋กœ ์‹คํ–‰
npm run dev

# ๋นŒ๋“œ
npm run build

# ์‹คํ–‰
npm start

API ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

๊ฒ€์ƒ‰์–ด ํŠธ๋ Œ๋“œ ์กฐํšŒ

{
  startDate: "2024-01-01",    // YYYY-MM-DD ํ˜•์‹
  endDate: "2024-01-31",      // YYYY-MM-DD ํ˜•์‹
  timeUnit: "date",           // "date" | "week" | "month"
  keywordGroups: [            // ์ตœ๋Œ€ 5๊ฐœ ๊ทธ๋ฃน
    {
      groupName: "๊ทธ๋ฃน1",
      keywords: ["๊ฒ€์ƒ‰์–ด1", "๊ฒ€์ƒ‰์–ด2"]  // ๊ทธ๋ฃน๋‹น ์ตœ๋Œ€ 5๊ฐœ
    }
  ],
  device: "pc",              // ์„ ํƒ์‚ฌํ•ญ: "pc" | "mo" | ""
  gender: "f",               // ์„ ํƒ์‚ฌํ•ญ: "f" | "m" | ""
  ages: ["20", "30"]         // ์„ ํƒ์‚ฌํ•ญ: ["1"~"11"]
}

์‡ผํ•‘์ธ์‚ฌ์ดํŠธ ๋ถ„์•ผ๋ณ„ ํŠธ๋ Œ๋“œ ์กฐํšŒ

{
  startDate: "2024-01-01",
  endDate: "2024-01-31",
  timeUnit: "date",
  category: [                 // ์ตœ๋Œ€ 3๊ฐœ ๋ถ„์•ผ
    {
      name: "ํŒจ์…˜์˜๋ฅ˜",
      param: ["50000000"]     // ๋„ค์ด๋ฒ„ ์‡ผํ•‘ ์นดํ…Œ๊ณ ๋ฆฌ ์ฝ”๋“œ
    }
  ],
  device: "pc",              // ์„ ํƒ์‚ฌํ•ญ
  gender: "f",               // ์„ ํƒ์‚ฌํ•ญ
  ages: ["20", "30"]         // ์„ ํƒ์‚ฌํ•ญ
}

์‡ผํ•‘์ธ์‚ฌ์ดํŠธ ํ‚ค์›Œ๋“œ๋ณ„ ํŠธ๋ Œ๋“œ ์กฐํšŒ

{
  startDate: "2024-01-01",
  endDate: "2024-01-31",
  timeUnit: "date",
  category: "50000000",      // ์‡ผํ•‘ ๋ถ„์•ผ ์ฝ”๋“œ
  keyword: [                 // ์ตœ๋Œ€ 3๊ฐœ ํ‚ค์›Œ๋“œ
    {
      name: "ํ‚ค์›Œ๋“œ1",
      param: ["๊ฒ€์ƒ‰์–ด1", "๊ฒ€์ƒ‰์–ด2"]  // ์ตœ๋Œ€ 5๊ฐœ
    }
  ],
  device: "pc",              // ์„ ํƒ์‚ฌํ•ญ
  gender: "f",               // ์„ ํƒ์‚ฌํ•ญ
  ages: ["20", "30"]         // ์„ ํƒ์‚ฌํ•ญ
}

์—ฐ๋ น๋Œ€ ์ฝ”๋“œ

  • "1": 0-12์„ธ
  • "2": 13-18์„ธ
  • "3": 19-24์„ธ
  • "4": 25-29์„ธ
  • "5": 30-34์„ธ
  • "6": 35-39์„ธ
  • "7": 40-44์„ธ
  • "8": 45-49์„ธ
  • "9": 50-54์„ธ
  • "10": 55-59์„ธ
  • "11": 60์„ธ ์ด์ƒ

API ์ฐธ๊ณ  ์ž๋ฃŒ

MCP ์„œ๋ฒ„ ์„ค์ •

MCP ์„œ๋ฒ„ ์‹คํ–‰

npx -y naver-datalab-mcp-server

MCP ์„ค์ • ์˜ˆ์‹œ

{
  "naver-datalab": {
    "command": "npx",
    "args": [
      "-y",
      "naver-datalab-mcp-server"
    ],
    "env": {
      "NAVER_CLIENT_ID": "your_naver_client_id_here",
      "NAVER_CLIENT_SECRET": "your_naver_client_secret_here"
    }
  }
}

์‹œ์Šคํ…œ ์š”๊ตฌ์‚ฌํ•ญ

  • Node.js >= 18.0.0

๋ผ์ด์„ ์Šค

MIT