MCP-CEP

ViaCEP 공개 API를 사용하여 우편번호를 쿼리하는 MCP 서버입니다.
명령줄 확장 기능으로 Goose 와 호환됩니다.

👤 저자

웬델 바레토
https://github.com/wendellbigato

🚀 설치

1. 이 저장소를 복제합니다.

지엑스피1

게시할 때는 위의 URL을 실제 URL로 변경해 주시기 바랍니다.

2. 가상 환경 생성 및 활성화

python3.11 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# ou
.venv\Scripts\activate.bat  # Windows

3. uv 또는 pip 사용하여 종속성을 설치합니다.

uv 사용 :

uv pip install -e ".[cli]"

또는 일반 pip를 사용하면:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Goose에서 확장 프로그램으로 설정하기

1. 실행하다:

goose configure

2. Add Extension 선택하세요

3. Command-line Extension 선택

4. 다음 필드를 채워주세요:

which uv 와 pwd 사용하여 올바른 경로를 찾습니다.

✅ 구스에서 테스트하는 방법

설정 후 시작:

goose session --with-extension mcp-cep

다음과 같은 명령을 보냅니다.

Repita: Olá!
Qual o endereço do CEP 01001000?

🧰 사용 가능한 도구

• echo(texto: str) : 보낸 텍스트를 반복합니다.

• buscar_cep(cep: str) : ViaCEP를 통해 주소 정보를 쿼리합니다.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.