식품 데이터 센터 MCP 서버

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

특징

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

# Set the USDA API key as an environment variable export USDA_API_KEY=your-api-key-here npm start

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

# Set the USDA API key as an environment variable export USDA_API_KEY=your-api-key-here npm run dev

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

Claude Desktop 설정을 엽니다.
- macOS: Claude 메뉴를 클릭하고 "설정..."을 선택하세요.
- Windows의 경우: Claude 메뉴를 클릭하고 "설정..."을 선택하세요.
설정 창에서 왼쪽 막대에 있는 "개발자"를 클릭한 다음 "구성 편집"을 클릭합니다.
이렇게 하면 다음 위치에 구성 파일이 생성되거나 열립니다.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
구성 파일에 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 값을 조정해야 할 수도 있습니다.
구성 파일을 저장하고 Claude Desktop을 다시 시작하세요.
재시작 후 입력란 오른쪽 하단에 망치 아이콘이 표시됩니다. 망치 아이콘을 클릭하면 사용 가능한 도구가 표시됩니다.

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

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"입니다.

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

food://details?fdcId=2345678&format=full

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

food://foods?fdcIds=534358,373052,616350

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

food://list?dataType=Foundation,SR Legacy&pageSize=10&pageNumber=1

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

{ "name": "search-foods", "arguments": { "query": "apple", "dataType": ["Foundation", "SR Legacy"], "pageSize": 10, "pageNumber": 1 } }