eBird MCP Server

eBird MCP 서버

eBird API와 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude와 같은 AI 도우미가 eBird의 조류 관찰 데이터, 핫스팟 및 분류 정보에 접근할 수 있습니다.

Claude Desktop을 위한 빠른 설정

Claude Desktop 구성 파일( ~/Library/Application Support/Claude/claude_desktop_config.json )에 다음 구성을 추가합니다.

지엑스피1

다음 사항을 확인하세요.

1. YOUR_EBIRD_API_KEY 실제 eBird API 키로 바꾸세요.
2. 구성 파일이 없으면 생성하세요
3. 아직 설치하지 않았다면 npm install -g ebird-mcp-server 사용하여 패키지를 전역적으로 설치하세요.
4. 변경 사항을 저장한 후 Claude Desktop을 다시 시작하세요.

참고 : eBird API 키는 eBird API 키 요청 에서 얻을 수 있습니다.

특징

eBird MCP 서버는 다음 eBird 데이터에 대한 액세스를 제공합니다.

• 최근 지역의 조류 관찰
• 특정 조류 종에 대한 최근 관찰
• 특정 지역의 주목할 만한 조류 관찰
• 위치 근처의 관찰
• 위치 근처의 주목할만한 관찰
• 지역의 조류 관찰 명소
• 위치 근처의 핫스팟
• eBird 분류 정보

필수 조건

• Node.js(v14 이상)
• eBird API 키( eBird API 키 요청 에서 하나 받음)

설치

클로드 데스크탑용

1. 이 저장소를 복제하거나 파일을 다운로드하세요
2. Claude Desktop 설치 스크립트를 실행합니다.

3. Claude Desktop을 다시 시작하세요

다른 MCP 클라이언트의 경우

1. 이 저장소를 복제하거나 파일을 다운로드하세요
2. 설치 스크립트를 실행합니다.

3. 이제 서버가 설치되었으며 다음을 사용하여 실행할 수 있습니다.

수동 설치

1. 이 저장소를 복제하거나 파일을 다운로드하세요
2. 종속성 설치:

3. 서버를 실행합니다:

사용 가능한 도구

ebird_get_recent_observations

특정 지역이나 장소에서 최근의 조류 관찰 결과를 받아보세요.

매개변수:

• regionCode (필수): 지역 코드(예: US, US-NY, L123456)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)
• hotspot : 핫스팟에서만 관찰 결과를 포함합니다(기본값: false)
• detail : 결과의 세부 수준('simple' 또는 'full', 기본값: 'simple')

ebird_get_recent_observations_for_species

특정 지역의 특정 조류 종에 대한 최근 관찰 결과를 받아보세요.

매개변수:

• regionCode (필수): 지역 코드(예: US, US-NY, L123456)
• speciesCode (필수): eBird 종 코드(예: American Crow의 경우 amecro)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)
• hotspot : 핫스팟에서만 관찰 결과를 포함합니다(기본값: false)

ebird_get_notable_observations

특정 지역의 주목할 만한 새를 관찰해 보세요.

매개변수:

• regionCode (필수): 지역 코드(예: US, US-NY, L123456)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• detail : 결과의 세부 수준('simple' 또는 'full', 기본값: 'simple')

ebird_get_nearby_observations

특정 장소 근처에서 관찰된 최근의 조류 정보를 얻으세요.

매개변수:

• lat (필수): 위도 좌표
• lng (필수): 경도 좌표
• dist : 위도/경도 지점으로부터의 거리(킬로미터) (기본값: 25)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)
• hotspot : 핫스팟에서만 관찰 결과를 포함합니다(기본값: false)
• detail : 결과의 세부 수준('simple' 또는 'full', 기본값: 'simple')

ebird_get_near_notable_observations

특정 장소 근처에서 주목할 만한 새를 관찰해 보세요.

매개변수:

• lat (필수): 위도 좌표
• lng (필수): 경도 좌표
• dist : 위도/경도 지점으로부터의 거리(킬로미터) (기본값: 25)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• detail : 결과의 세부 수준('simple' 또는 'full', 기본값: 'simple')

ebird_get_near_observations_for_species

특정 지역 근처의 특정 조류 종에 대한 최근 관찰 결과를 받아보세요.

매개변수:

• lat (필수): 위도 좌표
• lng (필수): 경도 좌표
• speciesCode (필수): eBird 종 코드(예: American Crow의 경우 amecro)
• dist : 위도/경도 지점으로부터의 거리(킬로미터) (기본값: 25)
• back : 관찰 결과를 찾기 위한 날짜 수(기본값: 14)
• maxResults : 반환할 최대 결과 수(기본값: 100)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)

이버드_겟_핫스팟

특정 지역의 조류 관찰 명소를 찾아보세요.

매개변수:

• regionCode (필수): 지역 코드(예: US, US-NY)
• back : 핫스팟 활동을 찾기 위한 일 수(기본값: 14)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)

이버드_인근_핫스팟_찾기

특정 장소 근처의 조류 관찰 명소를 찾아보세요.

매개변수:

• lat (필수): 위도 좌표
• lng (필수): 경도 좌표
• dist : 위도/경도 지점으로부터의 거리(킬로미터) (기본값: 25)
• back : 핫스팟 활동을 찾기 위한 일 수(기본값: 14)
• includeProvisional : 임시 관찰을 포함합니다(기본값: true)

ebird_get_taxonomy

eBird 분류 정보를 얻으세요.

매개변수:

• locale : 일반 이름에 대한 언어(기본값: 'en')
• cat : 필터링할 분류 범주(기본값: 'species')
• fmt : 응답 형식(기본값: 'json')

ebird_get_taxonomy_forms

특정 종에 대한 eBird 분류 양식을 받으세요.

매개변수:

• speciesCode (필수): eBird 종 코드

테스트

eBird MCP 서버를 테스트하려면 eBird API 키를 환경 변수로 설정하고 테스트 스크립트를 실행하세요.

디버그 모드

디버그 모드를 활성화하고 자세한 로깅을 보려면:

특허

MIT

감사의 말

• API를 제공해준 eBird
• 조류 보호에 관한 연구로 코넬 조류학 연구소에서 수상
• API 통합 프레임워크를 위한 모델 컨텍스트 프로토콜