ALAPI

공식

ALAPI MCP 도구, MCP를 통해 수백 개의 API 인터페이스 호출

GitHub
12

ALAPI MCP(으)로 무엇을 할 수 있나요?

  • IP 및 도메인 조회 — ip_query를 사용하여 모든 IPv4 또는 IPv6 주소의 지리적 위치와 ISP 정보를 확인합니다.
  • 날씨 보고서 — weather_query를 통해 중국 도시의 현재 날씨, 경보, 대기질 지수(AQI) 및 예보를 확인합니다.
  • 실시간 인기 순위 — 웨이보, 더우인, 터우탸오, 즈후, 바이두, 36Kr의 실시간 인기 주제를 가져옵니다.
  • 기업 인증 — 회사명 또는 통합사회신용코드로 중국 기업 등록 정보를 조회합니다.
  • 택배 추적 — 중통, 선통, 순펑, J&T, 베스트, 위안통 및 기타 업체의 배송 상태를 추적합니다.
  • 콘텐츠 검열 — 정책 위반 여부를 확인하며, AI 출력 검토 워크플로에 적합합니다.

문서

🔥 ALAPI MCP 서버

smithery badge License

이것은 ALAPI 기반의 MCP (Model Context Protocol) 서버 구현체로, MCP 프로토콜을 통해 ALAPI 인터페이스를 직접 호출하여 ALAPI의 풍부한 API 리소스를 MCP를 지원하는 다양한 AI 애플리케이션에 손쉽게 통합할 수 있습니다.

✨ 기능 특징

  • 🔍 풍부한 API 리소스 - IP 조회, 날씨 조회, 인기 검색어 순위, 기업 정보 등 100가지 이상의 자주 사용되는 API 서비스 제공
  • 🧩 MCP 프로토콜 지원 - Model Context Protocol 완벽 호환, 다양한 AI 애플리케이션에 손쉽게 통합
  • 🔄 자동 로딩 - ALAPI OpenAPI 규격을 자동으로 로딩하므로 수동 설정 불필요
  • 🎯 유연한 호출 - 전체 또는 특정 API 로딩 지원, 필요에 따라 사용 (숏폼 영상 분석, 날씨 조회, 매일 60초로 세계 읽기, 기업 조회 등)
  • 🛡️ 통합 응답 - 통합된 오류 처리 및 응답 형식 제공으로 개발 프로세스 간소화
  • ⚙️ 설정 가능성 - 환경 변수 설정 지원, 다양한 사용 시나리오에 쉽게 적용

📖 사용 가이드

먼저 MCP 프로토콜을 이해한 후, 아래 설정에 따라 ALAPI MCP 서비스를 추가하세요.

MCP 클라이언트에서 사용하기

ALAPI MCP 서버는 MCP 프로토콜을 지원하는 클라이언트와 함께 사용하도록 설계되었으며, 독립적인 명령줄 설정은 지원하지 않습니다. 다음 단계에 따라 MCP 클라이언트에서 설정하여 사용하세요:

방법 1: 원격 MCP

본 프로젝트는 텐센트 클라우드 개발 플랫폼에 원클릭 배포를 지원하며, 원격 SSE 접근을 제공합니다.

☁️ 클라우드 개발 플랫폼으로 이동하여 MCP 서버 배포하기

방법 2: Smithery를 사용한 자동 설치

Smithery를 통해 ALAPI MCP 서버를 설치하며, Claude Desktop 클라이언트에 적합합니다:

npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude

방법 3: 사전 컴파일된 바이너리 직접 사용 (권장, 의존성 설치 불필요)

  1. Releases 페이지에 접속하여 최신 버전 다운로드

    중국 내 빠른 다운로드 주소: https://cnb.cool/alapi/mcp-alapi-cn/-/releases

  2. 운영체제에 맞는 최신 버전 선택:

    • Windows: mcp-alapi-cn.exe
    • macOS: mcp-alapi-cn-macos
    • Linux: mcp-alapi-cn-linux

  3. MCP를 지원하는 클라이언트(예: Claude Desktop)에서 설정:

    • MCP 클라이언트 설정 열기
    • 새 MCP 서버 추가
    • 다운로드한 바이너리 파일 경로 지정
    • 필요한 환경 변수 설정 (예: ALAPI_TOKEN)

환경 변수 설정

ALAPI_TOKEN - ALAPI 플랫폼 접근 토큰 (필수)

ALAPI 플랫폼에서 생성한 TOKEN으로 설정해야 하며, 인터페이스 인증에 사용됩니다.

MCP 클라이언트 설정 예시

Claude Desktop 또는 기타 MCP 지원 클라이언트에서 다음 설정을 참고할 수 있습니다:

JSON 설정 (로컬 바이너리 파일 사용)

{
  "mcpServers": {
    "alapi": {
      "path": "/path/to/mcp-alapi-cn",
      "env": {
        "ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
      }
    }
  }
}

지원되는 MCP 클라이언트

MCP 문서에 따르면, 다음 클라이언트들이 MCP 도구 통합을 지원합니다:

  • Claude Desktop App
  • Claude Code
  • Cursor
  • Continue
  • Cline
  • 기타 MCP 프로토콜을 지원하는 클라이언트

참고: MCP 클라이언트가 도구 통합 기능을 지원하는지 확인하고, 각 클라이언트의 구체적인 문서를 참조하여 설정하세요.

🛠️ 지원 기능

다음은 지원되는 기능 중 일부이며, 전체 기능은 실제 호출을 기준으로 합니다:

기능명설명
IP 조회IP 소재지 정보 조회, IPv4 및 IPv6 지원
날씨 조회국내 날씨 상세 정보 조회, 날씨 정보, 기상 특보, 날씨 지수, AQI 등 포함
오늘의 인기 검색어오늘의 인기 검색어 데이터 조회, 더우인 인기 검색어, 토우티아오 인기 검색어, 즈후, 36kr, 바이두 인기 검색어, 웨이보 인기 검색어 등 데이터 포함
텍스트 검열텍스트 위반 여부 조회, 특히 AI 콘텐츠 검열에 적합
짧은 URL긴 URL을 짧은 URL로 단축, SMS 발송, QR 코드 생성 등 시나리오에 편리
QR 코드 인식한 이미지 내 여러 코드 지원, 2차원 코드, 바코드 인식 지원
오늘의 역사역사 속 지정된 날짜에 발생한 주요 사건 조회
환율 조회통화 코드에 따른 환율 및 환전 조회, 전 세계 170여 개 국가 및 지역 통화 조회 지원
기업 조회기업명 또는 통일사회신용코드에 따른 기업 기본 공상 정보 조회
택배 조회택배 물류 추적 무료 조회, 중통, 선통, 순펑, 지투, 바이스, 위안통 등 지원
별자리 운세별자리 운세 조회 서비스 제공, 12별자리 오늘 또는 내일, 이번 주, 이번 달, 올해 운세 조회 지원
금 시세현재 실시간 금 시세, 최고가, 최저가, 브랜드 금 시세 조회

🔗 관련 링크

🙏 감사의 말