Food Data Central MCP Server

식품 데이터 센터 MCP 서버

이는 USDA의 FoodData Central API 에 대한 API 액세스를 제공하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

• USDA FoodData Central 데이터베이스에서 식품 검색
• 식품 영양 정보 접근
• 페이지 매김 결과
• 다양한 데이터 유형 지원(Foundation, SR Legacy, Survey, Branded)

설정

1. 저장소를 복제합니다
2. 종속성 설치:지엑스피1
3. 프로젝트를 빌드하세요:
   npm run build

서버 실행

이 서버는 stdio 전송을 사용하는데, 이는 MCP 클라이언트에서 하위 프로세스로 실행되도록 설계되었음을 의미합니다. 직접 실행하려면 다음을 수행하세요.

핫 리로딩을 통한 개발의 경우:

Claude Desktop과 함께 사용

Claude Desktop과 함께 이 MCP 서버를 사용하려면:

1. Claude Desktop 설정을 엽니다.
   • macOS: Claude 메뉴를 클릭하고 "설정..."을 선택하세요.
   • Windows의 경우: Claude 메뉴를 클릭하고 "설정..."을 선택하세요.
2. 설정 창에서 왼쪽 막대에 있는 "개발자"를 클릭한 다음 "구성 편집"을 클릭합니다.
3. 이렇게 하면 다음 위치에 구성 파일이 생성되거나 열립니다.
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. 구성 파일에 Food Data Central MCP 서버를 추가합니다.
   { "mcpServers": { "food-data-central": { "command": "npx", "args": ["tsx", "/path/to/food-data-central-mcp-server/src/index.ts"], "env": { "PATH": "/opt/homebrew/bin", "USDA_API_KEY": "<INSERT KEY HERE>" } } } }
   /path/to/food-data-central-mcp-server 이 저장소의 절대 경로로 바꾸고, <INSERT KEY HERE> 실제 USDA API 키로 바꾸세요.참고: Windows를 사용하는 경우 npm 글로벌 설치 디렉터리를 포함하도록 PATH 값을 조정해야 할 수도 있습니다.
5. 구성 파일을 저장하고 Claude Desktop을 다시 시작하세요.
6. 재시작 후 입력란 오른쪽 하단에 망치 아이콘이 표시됩니다. 망치 아이콘을 클릭하면 사용 가능한 도구가 표시됩니다.

이제 Claude는 이 MCP 서버를 통해 Food Data Central API에 접근할 수 있습니다. Claude에게 식품 검색, 영양 정보 확인, 또는 자세한 식품 데이터 조회를 요청할 수 있습니다.

MCP 리소스 및 도구

자원

• food://details - ID로 특정 음식에 대한 자세한 정보를 가져옵니다.
  • 쿼리 매개변수:
    • fdcId : 식품 데이터 센터 ID(필수)
    • format : 선택 사항. 'abridged'는 축약된 요소 집합을 나타내고, 'full'은 모든 요소를 나타냅니다(기본값).
    • nutrients : 선택 사항. 최대 25개의 영양소 번호 목록(쉼표로 구분)
• food://foods - 입력 FDC ID를 사용하여 여러 식품 항목에 대한 세부 정보를 가져옵니다.
  • 쿼리 매개변수:
    • fdcIds : 여러 FDC ID 목록(필수, 쉼표로 구분)
    • format : 선택 사항. 'abridged'는 축약된 요소 집합을 나타내고, 'full'은 모든 요소를 나타냅니다(기본값).
    • nutrients : 선택 사항. 최대 25개의 영양소 번호 목록(쉼표로 구분)
• food://list - 음식 페이지 목록을 가져옵니다.
  • 쿼리 매개변수:
    • dataType : 선택 사항. 특정 데이터 유형을 필터링합니다(쉼표로 구분된 목록).
    • pageSize : 선택 사항. 반환할 최대 결과 수(기본값: 50)
    • pageNumber : 선택 사항. 검색할 페이지 번호(기본값: 1)
    • sortBy : 선택 사항. 정렬 기준 필드
    • sortOrder : 선택 사항입니다. 정렬 순서는 "asc" 또는 "desc"입니다.

도구

• search-foods - 키워드를 사용하여 음식 검색
  • 매개변수:
    • query : 음식을 찾기 위한 검색어 (필수)
    • dataType : 선택 사항. 특정 데이터 유형(문자열 배열)을 필터링합니다.
    • pageSize : 선택 사항. 반환할 최대 결과 수(기본값: 50)
    • pageNumber : 선택 사항. 검색할 페이지 번호(기본값: 1)
    • sortBy : 선택 사항. 정렬 기준 필드
    • sortOrder : 선택 사항입니다. 정렬 순서는 "asc" 또는 "desc"입니다.
    • brandOwner : 선택 사항. 식품의 브랜드 소유자를 기준으로 결과를 필터링합니다(브랜드 식품에만 해당).
    • tradeChannel : 선택 사항. 지정된 거래 채널을 포함하는 식품을 필터링합니다.
    • startDate : 선택 사항. 이 날짜 이후에 게시된 식품을 필터링합니다(형식: YYYY-MM-DD).
    • endDate : 선택 사항. 해당 날짜 또는 그 이전에 게시된 식품을 필터링합니다(형식: YYYY-MM-DD).

사용 예

MCP 리소스를 사용하여 음식 세부 정보를 얻으세요:

MCP 리소스를 사용하여 다양한 음식을 얻으세요:

MCP 리소스를 사용하여 식품 목록을 가져옵니다.

MCP 도구를 사용하여 음식을 검색하세요: