{"id":30272082,"url":"https://github.com/slicequeue/k-mfds-fooddb-mcp-server","last_synced_at":"2025-10-06T13:05:01.529Z","repository":{"id":305901325,"uuid":"1023070167","full_name":"slicequeue/k-mfds-fooddb-mcp-server","owner":"slicequeue","description":"식품의약품안전처(K-MFDS) 식품영양성분DB를 MCP(Model Context Protocol) 도구","archived":false,"fork":false,"pushed_at":"2025-08-02T15:50:33.000Z","size":236,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-09T09:29:12.479Z","etag":null,"topics":["food"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slicequeue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-20T13:15:13.000Z","updated_at":"2025-08-02T15:50:37.000Z","dependencies_parsed_at":"2025-07-22T16:36:05.083Z","dependency_job_id":null,"html_url":"https://github.com/slicequeue/k-mfds-fooddb-mcp-server","commit_stats":null,"previous_names":["slicequeue/k-mfds-fooddb-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/slicequeue/k-mfds-fooddb-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fk-mfds-fooddb-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fk-mfds-fooddb-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fk-mfds-fooddb-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fk-mfds-fooddb-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slicequeue","download_url":"https://codeload.github.com/slicequeue/k-mfds-fooddb-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slicequeue%2Fk-mfds-fooddb-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270670063,"owners_count":24625444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["food"],"created_at":"2025-08-16T05:13:14.494Z","updated_at":"2025-10-06T13:05:01.437Z","avatar_url":"https://github.com/slicequeue.png","language":"TypeScript","funding_links":[],"categories":["목록 (List)"],"sub_categories":["📊 Public Data"],"readme":"# K-MFDS FoodDB MCP Server\n\n\u003e **식품의약품안전처(K-MFDS) 식품영양성분DB를 MCP(Model Context Protocol) 도구로 바로 활용!**\n\n[![smithery badge](https://smithery.ai/badge/@slicequeue/k-mfds-fooddb-mcp-server)](https://smithery.ai/server/@slicequeue/k-mfds-fooddb-mcp-server)\n[![GitHub](https://img.shields.io/badge/GitHub-Repository-blue?style=flat-square\u0026logo=github)](https://github.com/slicequeue/k-mfds-fooddb-mcp-server)\n[![npm](https://img.shields.io/badge/npm-package-green?style=flat-square\u0026logo=npm)](https://www.npmjs.com/package/k-mfds-fooddb-mcp-server)\n\n## 실행 화면\n\n| 예시1 일반 검색                                                                                                       |\n| --------------------------------------------------------------------------------------------------------------------- |\n| \u003cimg width=\"800\" alt=\"image\" src=\"https://github.com/user-attachments/assets/2781d2d6-2566-4ddb-8afb-64d2dea86816\" /\u003e |\n\n| 예시2 응용 검색                                                                                                                                                                                                                            |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg width=\"800\" alt=\"image\" src=\"https://github.com/user-attachments/assets/4b2baa3a-523e-49be-a916-ebe8cd01264e\" /\u003e\u003cimg width=\"800\" alt=\"image\" src=\"https://github.com/user-attachments/assets/39719b71-f2de-44b9-9b50-a6e5dba4da6f\" /\u003e |\n\n**사용방법은 아래 `🛠️ 사용 가능한 MCP 도구`를 참고해주세요 :)**\n\n---\n\n## ✨ 빠른 시작 (npx)\n\n```bash\nnpx k-mfds-fooddb-mcp-server\n```\n\n- MCP 호환 플랫폼(예: ModelContext, MCP SDK 등)에서 바로 실행할 수 있습니다.\n- 표준 입력/출력(STDIO) 기반 MCP 서버로 동작합니다.\n\n---\n\n## 🚀 MCP 클라이언트 설정\n\n### Gemini (Google AI Studio)\n\n1. **Google AI Studio**에서 새 프로젝트 생성\n2. **Tools** 섹션에서 **Add tool** 클릭\n3. **MCP Server** 선택\n4. 설정:\n   ```\n   Name: K-MFDS FoodDB\n   Command: npx k-mfds-fooddb-mcp-server\n   ```\n5. **Save** 클릭\n\n### Cursor\n\n1. **Cursor** 설정에서 **Extensions** → **MCP** 활성화\n2. `~/.cursor/mcp_servers.json` 파일 생성/수정:\n   ```json\n   {\n     \"mcpServers\": {\n       \"k-mfds-fooddb\": {\n         \"command\": \"npx\",\n         \"args\": [\"k-mfds-fooddb-mcp-server\"],\n         \"env\": {\n           \"GOV_API_KEY\": \"발급받은_식약처_API_키\"\n         }\n       }\n     }\n   }\n   ```\n3. Cursor 재시작\n\n\u003e 💡 **환경변수 설정**: `env` 섹션에 `GOV_API_KEY`를 추가하세요. API 키는 [공공데이터포털](https://www.data.go.kr/data/15000161/openapi.do)에서 발급받을 수 있습니다.\n\n### Continue\n\n1. **Continue** 설정에서 **MCP Servers** 섹션으로 이동\n2. 새 서버 추가:\n   ```yaml\n   Name: k-mfds-fooddb\n   Command: npx k-mfds-fooddb-mcp-server\n   Environment Variables:\n     GOV_API_KEY: 발급받은_식약처_API_키\n   ```\n3. **Save** 클릭\n\n\u003e 💡 **환경변수 설정**: Environment Variables 섹션에 `GOV_API_KEY`를 추가하세요.\n\n### ModelContext\n\n1. **ModelContext** 설정에서 **MCP Servers** 탭\n2. **Add Server** 클릭\n3. 설정:\n   ```json\n   {\n     \"name\": \"K-MFDS FoodDB\",\n     \"command\": \"npx\",\n     \"args\": [\"k-mfds-fooddb-mcp-server\"],\n     \"env\": {\n       \"GOV_API_KEY\": \"발급받은_식약처_API_키\"\n     }\n   }\n   ```\n4. **Connect** 클릭\n\n\u003e 💡 **환경변수 설정**: `env` 섹션에 `GOV_API_KEY`를 추가하세요.\n\n### 기타 MCP 호환 클라이언트\n\n대부분의 MCP 호환 클라이언트에서 다음과 같이 설정:\n\n```json\n{\n  \"name\": \"k-mfds-fooddb\",\n  \"command\": \"npx\",\n  \"args\": [\"k-mfds-fooddb-mcp-server\"],\n  \"env\": {\n    \"GOV_API_KEY\": \"발급받은_식약처_API_키\"\n  }\n}\n```\n\n\u003e 💡 **환경변수 설정**: `env` 섹션에 `GOV_API_KEY`를 추가하세요. API 키는 [공공데이터포털](https://www.data.go.kr/data/15000161/openapi.do)에서 발급받을 수 있습니다.\n\n---\n\n## 📦 설치 (npm)\n\n### Installing via Smithery\n\nTo install k-mfds-fooddb-mcp-server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@slicequeue/k-mfds-fooddb-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @slicequeue/k-mfds-fooddb-mcp-server --client claude\n```\n\n### Installing manually\n```bash\nnpm install -g k-mfds-fooddb-mcp-server\n# 또는 프로젝트에 설치\nnpm install k-mfds-fooddb-mcp-server\n```\n\n---\n\n## ⚡ 환경 변수 설정\n\n1. `.env` 파일을 프로젝트 루트에 생성하세요. (예시: `env.example` 참고)\n2. 필수 항목:\n   - `GOV_API_KEY`: 식품의약품안전처 OpenAPI 키\n\n```env\nGOV_API_KEY=발급받은_식약처_API_키\n```\n\n\u003e API 키는 [공공데이터포털](https://www.data.go.kr/data/15000161/openapi.do)에서 신청/발급받을 수 있습니다.\n\n---\n\n## 🛠️ 사용 가능한 MCP 도구\n\n### 1. 식품 검색 도구 (`searchFoodNutrition`)\n\n- **설명**: 식품명, 제조사, 카테고리 등 다양한 조건으로 식품 영양성분 정보를 검색합니다.\n- **입력 파라미터**:\n  - `foodNameKr`: 식품명 (예: \"사과\")\n  - `makerName`: 제조사명 (예: \"농심\")\n  - `foodCategory1Name`: 식품 대분류명 (예: \"과일류\")\n  - `itemReportNo`: 품목제조보고번호\n  - `researchYearMonthDate`: 데이터 생성일자 (YYYYMMDD)\n  - `pageNo`: 페이지 번호 (기본값: 1)\n  - `numOfRows`: 한 페이지 결과수 (기본값: 10, 최대: 100)\n  - `updateDate`: 데이터 수정일자 (YYYYMMDD)\n  - `dbClassName`: 품목대표/상용제품 구분\n\n#### ✅ 예시 요청\n\n```json\n{\n  \"foodNameKr\": \"사과\",\n  \"numOfRows\": 5\n}\n```\n\n#### ✅ 예시 응답\n\n```json\n{\n  \"data\": [\n    {\n      \"foodNameKr\": \"사과\",\n      \"makerName\": \"농협\",\n      \"foodCategory1Name\": \"과일류\",\n      \"servingSize\": \"100g\",\n      \"nutritionComponents\": [\n        { \"name\": \"열량\", \"value\": \"52\", \"unit\": \"kcal\" },\n        { \"name\": \"단백질\", \"value\": \"0.3\", \"unit\": \"g\" }\n      ],\n      \"itemReportNum\": \"2020123456789\",\n      \"researchDate\": \"20201201\"\n    }\n  ],\n  \"paging\": {\n    \"totalCount\": \"100\",\n    \"pageNo\": \"1\",\n    \"numOfRows\": \"10\"\n  }\n}\n```\n\n---\n\n### 2. 영양성분 코드 조회 도구 (`getNutritionComponentTypes`)\n\n- **설명**: 식품영양성분DB에서 제공하는 영양성분 코드/이름/단위 목록을 조회합니다.\n- **입력 파라미터**: 없음\n\n#### ✅ 예시 응답\n\n```json\n{\n  \"items\": [\n    {\n      \"code\": \"AMT_NUM1\",\n      \"name\": \"에너지\",\n      \"label\": \"에너지(kcal)\",\n      \"unit\": \"kcal\"\n    },\n    { \"code\": \"AMT_NUM2\", \"name\": \"수분\", \"label\": \"수분(g)\", \"unit\": \"g\" },\n    { \"code\": \"AMT_NUM3\", \"name\": \"단백질\", \"label\": \"단백질(g)\", \"unit\": \"g\" }\n    // ... 이하 생략\n  ]\n}\n```\n\n---\n\n## 💬 실제 사용 예시 (LLM 질문)\n\n### 🍎 식품 검색 도구 사용 예시\n\n**Claude/Cursor에서 다음과 같이 질문하세요:**\n\n\u003e \"사과의 영양성분 정보를 알려줘\"\n\n\u003e \"농심에서 만드는 라면의 영양성분을 검색해줘\"\n\n\u003e \"과일류 카테고리에서 칼로리가 낮은 식품들을 찾아줘\"\n\n### 📊 영양성분 코드 조회 도구 사용 예시\n\n**Claude/Cursor에서 다음과 같이 질문하세요:**\n\n\u003e \"식품영양성분DB에서 제공하는 영양성분 코드 목록을 보여줘\"\n\n\u003e \"어떤 영양성분들을 조회할 수 있나요?\"\n\n\u003e \"영양성분 단위 정보를 알려줘\"\n\n\u003e \"식품영양성분DB의 영양성분 분류 체계를 설명해줘\"\n\n### 🎯 실제 대화 예시\n\n**사용자**: \"사과의 영양성분을 알려줘\"\n\n**AI**: \"사과의 영양성분 정보를 검색해드리겠습니다.\"\n\n_[MCP 도구 호출: searchFoodNutrition]_\n\n**AI**: \"사과의 영양성분 정보입니다:\n\n- 열량: 52 kcal (100g 기준)\n- 단백질: 0.3g\n- 지방: 0.2g\n- 탄수화물: 13.8g\n- 식이섬유: 2.4g\n  ...\"\n\n**사용자**: \"어떤 영양성분들을 조회할 수 있나요?\"\n\n**AI**: \"식품영양성분DB에서 제공하는 영양성분 코드 목록을 확인해드리겠습니다.\"\n\n_[MCP 도구 호출: getNutritionComponentTypes]_\n\n**AI**: \"다음과 같은 영양성분들을 조회할 수 있습니다:\n\n- 에너지 (kcal)\n- 수분 (g)\n- 단백질 (g)\n- 지방 (g)\n- 탄수화물 (g)\n- 식이섬유 (g)\n- 회분 (g)\n- 나트륨 (mg)\n- 칼륨 (mg)\n  ...\"\n\n### 🔍 고급 검색 예시\n\n**사용자**: \"닭가슴살 중에 칼로리가 낮고 단백질이 높은 식품을 찾아줘\"\n\n**AI**: \"닭가슴살 관련 식품 중에서 칼로리가 낮고 단백질이 높은 것들을 검색해드리겠습니다. 식품영양성분DB에서 닭가슴살 관련 제품들을 찾아보겠습니다.\"\n\n_[MCP 도구 호출: searchFoodNutrition]_\n\n**AI**: \"식품영양성분DB에서 닭가슴살 관련 제품들을 검색한 결과, 다음과 같은 식품들을 추천드립니다:\n\n1. 닭가슴살 (생것, 100g 기준)\n   - 열량: 165 kcal\n   - 단백질: 31g\n   - 지방: 3.6g\n2. 닭가슴살 (구운것, 100g 기준)\n   - 열량: 165 kcal\n   - 단백질: 31g\n   - 지방: 3.6g\n3. 닭가슴살 (삶은것, 100g 기준)\n   - 열량: 165 kcal\n   - 단백질: 31g\n   - 지방: 3.6g\n4. 닭가슴살 (튀긴것, 100g 기준)\n   - 열량: 165 kcal\n   - 단백질: 31g\n   - 지방: 3.6g\n     ...\"\n\n---\n\n## 🏃 MCP 서버 직접 실행 예시\n\n```bash\nnpx k-mfds-fooddb-mcp-server\n```\n\n- MCP 플랫폼에서 자동으로 도구를 인식/등록합니다.\n- STDIO 기반이므로, MCP SDK/ModelContext 등에서 바로 연결해 사용할 수 있습니다.\n\n---\n\n## 🏗️ 프로젝트 구조 (참고)\n\n```\nsrc/\n├── config/           # 환경변수 및 설정\n├── external/         # 외부 API 연동/매핑\n├── tools/            # MCP 도구 구현\n└── index.ts          # MCP 서버 진입점\n```\n\n---\n\n## 🧪 테스트\n\n```bash\nnpm test\n```\n\n---\n\n## 🤝 기여 및 문의\n\n- Pull Request/이슈 환영합니다!\n- 문의: [GitHub Issues](https://github.com/slicequeue/k-mfds-fooddb-mcp-server/issues)\n- 저장소: [GitHub Repository](https://github.com/slicequeue/k-mfds-fooddb-mcp-server)\n\n---\n\n## 📄 라이선스\n\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslicequeue%2Fk-mfds-fooddb-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslicequeue%2Fk-mfds-fooddb-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslicequeue%2Fk-mfds-fooddb-mcp-server/lists"}