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를 사용하면:
🧩 Goose에서 확장 프로그램으로 설정하기
- 실행하다:
Add Extension
선택하세요Command-line Extension
선택- 다음 필드를 채워주세요:
필드 | 값 |
---|
확장자 이름 | mcp-cep |
실행 명령 | /caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py |
타임아웃 | 300 |
환경 | (필요한 경우 비워두거나 사용자 정의) |
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 라이선스에 따라 라이선스가 부여되었습니다.