Vonage AI 코드 지원 MCP 서버

개요

Vonage AI Code Assist는 개발자가 Vonage API 기능을 애플리케이션에 통합할 수 있도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 FastMCP를 활용하여 AI 기반 Vonage 문서 접근을 지원하여 개발자가 Vonage 통신 API 관련 정보를 빠르게 찾을 수 있도록 합니다.

Related MCP server: API Docs MCP Server

작동 원리

Vonage Assist MCP 서버는 다음과 같이 작동합니다.

1. 문서 검색 : 이 서버는 Vonage의 공식 문서를 검색하는 "Vonage-Assist"라는 특수 도구를 제공합니다.

2. 웹 검색 통합 : Google Serper API를 사용하여 이 도구는 Vonage 개발자 문서 도메인( developer.vonage.com/en/documentation ) 내에서 타겟 검색을 수행합니다.

3. 콘텐츠 추출 : 검색 쿼리가 제출되면 서버는 다음을 수행합니다.

   • 사이트별 검색 쿼리를 공식화합니다.

   • Google Serper API에 쿼리를 보냅니다.

   • 관련 문서 링크가 포함된 검색 결과를 받습니다.

   • 이 링크에서 콘텐츠를 가져옵니다.

   • 추출된 텍스트 콘텐츠를 사용자에게 반환합니다.

4. MCP 도구 통합 : 이 서버는 Claude 및 MCP 프로토콜을 지원하는 다른 AI 어시스턴트와 호환되므로 이러한 AI 시스템은 응답에서 Vonage 문서를 직접 활용할 수 있습니다.

설정 및 요구 사항

Vonage Assist MCP 서버를 실행하려면:

1. Python 3.13 이상이 설치되어 있는지 확인하세요.

2. 필요한 환경 변수를 설정하세요.

   • SERPER_API_KEY : Google Serper의 API 키(웹 검색에 필요)

3. 종속성 설치:

   지엑스피1

4. 서버를 실행합니다:

   python main.py

용법

MCP 서버를 실행하면 다음 매개변수를 사용하여 Vonage-Assist 도구가 노출됩니다.

• query : 검색 쿼리(예: "번호 확인", "SMS API")

• library : 검색할 문서 라이브러리(현재 지원되는 유일한 옵션은 "vonage")

예시 도구 사용(MCP 호환 AI를 통해):

Use the Vonage-Assist tool to find information about implementing two-factor authentication with Vonage APIs.

기술 구현

서버는 다음을 사용하여 구축되었습니다.

• MCP 서버 프레임워크를 위한 FastMCP

• 비동기 HTTP 요청을 위한 httpx

• HTML 파싱 및 텍스트 추출을 위한 BeautifulSoup

• 환경 변수 관리를 위한 python-dotenv

핵심 기능은 다음과 같은 몇 가지 주요 기능을 통해 구현됩니다.

• search_web() : Google Serper에 API 요청을 수행합니다.

• fetch_url() : 웹 페이지에서 콘텐츠를 검색하고 추출합니다.

• vonage_docs() : 검색 및 콘텐츠 검색 프로세스를 조율하는 주요 도구 함수

향후 고려 사항

Vonage Assist MCP 서버의 잠재적 개선 사항:

1. 코드 생성 도구 : 여러 프로그래밍 언어로 일반적인 Vonage API 통합(SMS, 음성, Verify, 비디오)을 위한 샘플 코드 조각을 생성하는 기능을 추가하여 개발자가 적절한 구문과 모범 사례를 통해 Vonage 기능을 신속하게 구현할 수 있도록 지원합니다.

2. API 매개변수 도우미 : 매개변수 제안, 입력 검증, 다양한 Vonage API 엔드포인트에 대한 필수 필드와 선택 필드 설명을 통해 개발자가 유효한 API 요청을 구성하는 데 도움이 되는 도구를 개발합니다.

3. 문제 해결 지원 : 오류 코드를 분석하고 KB 문서와 설명서를 기반으로 실행 가능한 솔루션을 제공하여 일반적인 통합 문제를 진단하는 기능을 구현합니다. 이를 통해 디버깅 시간을 크게 단축합니다.

4. 웹훅 구성 도우미 : Vonage 서비스에 대한 웹훅 엔드포인트 설정 및 테스트를 지원하는 도구를 만들고, 개발자에게 콜백 및 이벤트 처리 프로세스를 안내합니다.

5. 모범 사례 어드바이저 : Vonage API를 구현할 때 성능, 보안 및 복원력에 대한 컨텍스트별 모범 사례를 제공하는 기능을 추가하여 개발자가 보다 강력한 애플리케이션을 구축할 수 있도록 지원합니다.

6. 요금 제한 및 가격 추정기 : 개발자가 비용을 추정하고 특정 사용 사례에 대한 요금 제한을 이해하는 데 도움이 됩니다.