Amazon Q MCP Servers

이 저장소는 Amazon Q CLI와 함께 사용할 수 있는 Model Context Protocol(MCP) 서버 모음입니다. MCP는 LLM(Large Language Model)이 외부 도구와 통신할 수 있게 해주는 개방형 프로토콜입니다.

포함된 서버

날씨 정보 서버 (weather)

미국 국립 기상 서비스(National Weather Service) API를 활용하여 미국 지역의 날씨 정보를 제공합니다.

• 위도와 경도를 기반으로 한 날씨 예보 제공
• 미국 주별 날씨 경보 조회 기능
• 기온, 바람, 상세 예보 등 정보 제공

AWS 뉴스 서버 (aws-news)

AWS 관련 최신 뉴스와 블로그 포스트를 조회할 수 있는 서버입니다.

• AWS 서비스/주제별 뉴스 검색
• 뉴스 타입 필터링 (뉴스, 블로그 또는 모두)
• 지역 확장 뉴스 포함 여부 설정
• 결과 수 제한 설정
• 특정 날짜 이후의 뉴스만 조회 가능

AWS 가격 정보 서버 (aws-pricing)

AWS EC2 인스턴스 가격 정보를 제공하는 서버입니다.

• 다양한 필터링 옵션을 통한 EC2 인스턴스 가격 조회
• 리전, 플랫폼, 테넌시, 가격 모델 등 상세 필터링 지원
• vCPU, 메모리, GPU, 네트워크 성능 등 하드웨어 요구사항 기반 필터링
• 가격 기준 정렬 및 페이지네이션 기능
• 기본 리전은 ap-northeast-2(서울)로 설정

설치 및 설정 방법

필요 조건

• Python 3.9 이상
• httpx 라이브러리

설치 단계

1. 이 저장소를 클론합니다:

git clone https://github.com/whchoi98/mcp-servers.git
cd mcp-servers

2. 각 서버 디렉토리에서 필요한 패키지를 설치합니다:

cd weather
pip install -r requirements.txt
cd ../aws-news
pip install -r requirements.txt
cd ../aws-pricing
pip install -r requirements.txt

3. Amazon Q CLI 설정 파일을 생성하거나 수정합니다:

mkdir -p ~/.q

4. ~/.q/mcp_config.json 파일에 다음 내용을 추가합니다:

{
  "mcpServers": {
    "aws-pricing": {
      "command": "python3",
      "args": [
        "/path/to/mcp-servers/aws-pricing/aws_pricing_server.py"
      ]
    },
    "aws-news": {
      "command": "python3",
      "args": [
        "/path/to/mcp-servers/aws-news/aws_news_server.py"
      ]
    },
    "weather": {
      "command": "python3",
      "args": [
        "/path/to/mcp-servers/weather/server.py"
      ]
    }
  }
}

사용 방법

날씨 서버 사용 예시

Amazon Q CLI에서 다음과 같은 질문을 할 수 있습니다:

• "워싱턴 주의 날씨 경보를 알려줘"
• "시애틀의 날씨 예보를 알려줘" (위도/경도 기반)

AWS 뉴스 서버 사용 예시

Amazon Q CLI에서 다음과 같은 질문을 할 수 있습니다:

• "Lambda에 관한 최신 AWS 뉴스를 알려줘"
• "S3 관련 AWS 블로그 포스트를 보여줘"
• "EC2에 관한 최근 발표 내용을 알려줘"

AWS 가격 정보 서버 사용 예시

Amazon Q CLI에서 다음과 같은 질문을 할 수 있습니다:

• "서울 리전에서 가장 저렴한 EC2 인스턴스는 무엇인가요?"
• "vCPU가 4개 이상이고 메모리가 16GB 이상인 EC2 인스턴스 가격을 알려주세요"
• "GPU가 있는 EC2 인스턴스 중 가장 저렴한 것은 무엇인가요?"
• "Windows 운영체제를 사용하는 EC2 인스턴스의 가격을 알려주세요"
• "m5 인스턴스 패밀리의 가격 정보를 보여주세요"

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여 방법

1. 이 저장소를 포크합니다.
2. 새로운 브랜치를 생성합니다 (git checkout -b feature/amazing-feature).
3. 변경 사항을 커밋합니다 (git commit -m 'Add some amazing feature').
4. 브랜치에 푸시합니다 (git push origin feature/amazing-feature).
5. Pull Request를 생성합니다.