atmospore-mcp

Atmospore를 위한 MCP 서버입니다. Claude(및 MCP를 지원하는 기타 AI 어시스턴트)가 지구상 어디에서나 꽃가루 예보에 대한 질문에 답할 수 있도록 합니다.

기능

Claude에 네 가지 도구를 추가합니다:

그리고 하나의 리소스:

• atmospore://help — Claude Desktop에서 탐색 가능한 사용 참고 사항

좌표는 지구 어디에서나 작동하며, 모델은 약 28km 해상도로 전 세계를 커버합니다.

설치

pip install atmospore-mcp

Claude Desktop 설정

1. atmospore.com/account에서 무료 Atmospore API 키를 받으세요. (하루 100회 호출, 신용카드 불필요).

2. Claude Desktop 설정을 편집하세요:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%/Claude/claude_desktop_config.json

3. Atmospore를 MCP 서버로 추가하세요:

{
  "mcpServers": {
    "atmospore": {
      "command": "atmospore-mcp",
      "env": {
        "ATMOSPORE_API_KEY": "ak_your_key_here"
      }
    }
  }
}

4. Claude Desktop을 재시작하세요.

5. Claude에게 "오늘 오슬로의 꽃가루는 어때?"라고 물어보세요. 도구를 호출하여 결과를 알려줄 것입니다.

예시 프롬프트

• "이번 주 오슬로의 꽃가루 예보는 어때?"

• "지금 스톡홀름에서 나무 꽃가루와 잔디 꽃가루 중 어느 것이 더 심해?"

• "나는 자작나무 알레르기가 있어. 베르겐에서 자작나무 꽃가루가 언제 최고조에 달해?"

• "오늘 런던과 코펜하겐의 꽃가루 수치를 비교해 줘."

할당량

각 도구 호출은 Atmospore API를 사용하며 키의 일일 할당량에서 차감됩니다. 무료 티어(하루 100회 호출)는 일반적인 사용량을 지원하며, 일반적인 Claude 대화는 1~5회의 도구 호출을 발생시킵니다. 헤비 유저(하루 약 5회 이상의 꽃가루 관련 대화)는 유료 플랜이 필요할 것입니다.

할당량을 초과하면 도구는 구조화된 quota_exceeded 응답을 반환하며, Claude는 평이한 언어로 다음과 같이 알려줍니다: "Atmospore 일일 한도에 도달했습니다. atmospore.com/plans에서 업그레이드하세요."

로컬 개발

git clone https://github.com/atmospore/atmospore-mcp
cd atmospore-mcp
pip install -e ".[test]"
pytest
ATMOSPORE_API_KEY=ak_... atmospore-mcp  # runs the server on stdio

관련 항목

• atmospore — 이 서버가 래핑하는 기본 Python 클라이언트.

• atmospore.com — 호스팅된 예보 및 개발자 대시보드.

라이선스

MIT.