Weather MCP Server

이것은 모의 응답을 제공하는 날씨 도구를 구현한 Python 샘플 MCP Server입니다. 자신의 MCP Server를 위한 스캐폴드로 사용할 수 있습니다. 다음 기능들을 포함합니다:

날씨 도구: 주어진 위치를 기반으로 모의 날씨 정보를 제공하는 도구입니다.
Agent Builder와 연결: 테스트 및 디버깅을 위해 MCP 서버를 Agent Builder에 연결할 수 있는 기능입니다.
MCP Inspector에서 디버깅: MCP Inspector를 사용하여 MCP Server를 디버깅할 수 있는 기능입니다.

Weather MCP Server 템플릿 시작하기

필수 조건

로컬 개발 머신에서 MCP Server를 실행하려면 다음이 필요합니다:

Python

(선택 사항 - uv를 선호하는 경우) uv

Python Debugger Extension

환경 준비

이 프로젝트의 환경을 설정하는 두 가지 방법이 있습니다. 선호에 따라 하나를 선택할 수 있습니다.

참고: 가상 환경 생성 후 가상 환경의 파이썬이 사용되도록 VSCode 또는 터미널을 다시 로드하세요.

방법	단계
`uv` 사용	1. 가상 환경 생성: `uv venv` 2. VSCode 명령어 "Python: Select Interpreter" 실행 후 생성한 가상 환경의 파이썬 선택 3. 의존성 설치(개발 의존성 포함): `uv pip install -r pyproject.toml --extra dev`
`pip` 사용	1. 가상 환경 생성: `python -m venv .venv` 2. VSCode 명령어 "Python: Select Interpreter" 실행 후 생성한 가상 환경의 파이썬 선택 3. 의존성 설치(개발 의존성 포함): `pip install -e .[dev]`

환경 설정 후, MCP Client로서 로컬 개발 머신에서 Agent Builder를 통해 서버를 실행할 수 있습니다:

VS Code 디버그 패널을 엽니다. Debug in Agent Builder를 선택하거나 F5를 눌러 MCP 서버 디버깅을 시작합니다.
Microsoft Foundry Toolkit Agent Builder를 사용하여 이 프롬프트로 서버를 테스트합니다. 서버가 자동으로 Agent Builder에 연결됩니다.
Run을 클릭하여 프롬프트로 서버를 테스트합니다.

축하합니다! Agent Builder를 통해 MCP Client로서 로컬 개발 머신에서 Weather MCP Server를 성공적으로 실행하였습니다.

템플릿에 포함된 항목

폴더 / 파일	내용
`.vscode`	디버깅용 VSCode 파일
`.aitk`	Microsoft Foundry Toolkit 설정 파일
`src`	weather mcp 서버 소스 코드

Weather MCP Server 디버깅 방법

참고:

MCP Inspector는 MCP 서버를 테스트 및 디버깅할 수 있는 비주얼 개발 도구입니다.

모든 디버깅 모드는 중단점(breakpoint)을 지원하므로 도구 구현 코드에 중단점을 추가할 수 있습니다.

디버깅 모드	설명	디버깅 단계
Agent Builder	Microsoft Foundry Toolkit의 Agent Builder에서 MCP 서버를 디버깅합니다.	1. VS Code 디버그 패널을 엽니다. `Debug in Agent Builder` 선택 후 `F5`를 눌러 MCP 서버 디버깅을 시작합니다. 2. Microsoft Foundry Toolkit Agent Builder를 사용하여 이 프롬프트로 서버를 테스트합니다. 서버가 자동으로 Agent Builder에 연결됩니다. 3. `Run`을 클릭하여 프롬프트로 서버를 테스트합니다.
MCP Inspector	MCP Inspector를 사용하여 MCP 서버를 디버깅합니다.	1. Node.js 설치 2. Inspector 준비: `cd inspector` && `npm install` 3. VS Code 디버그 패널을 엽니다. `Debug SSE in Inspector (Edge)` 또는 `Debug SSE in Inspector (Chrome)` 선택 후 `F5`를 눌러 디버깅을 시작합니다. 4. 브라우저에서 MCP Inspector가 실행되면 `Connect` 버튼을 눌러 MCP 서버에 연결합니다. 5. 그 후 `List Tools`로 도구를 선택하고, 매개변수를 입력하며, `Run Tool`로 서버 코드를 디버깅할 수 있습니다.

기본 포트 및 커스터마이징

디버그 모드	포트	정의	커스터마이징	비고
Agent Builder	3001	tasks.json	launch.json, tasks.json, __init__.py, mcp.json에서 위 포트 변경 가능	해당 없음
MCP Inspector	3001 (서버), 5173 및 3000 (Inspector)	tasks.json	launch.json, tasks.json, __init__.py, mcp.json에서 위 포트 변경 가능	해당 없음

피드백

이 템플릿에 대한 피드백이나 제안이 있으시면 Microsoft Foundry Toolkit GitHub 저장소에 이슈를 남겨주세요.

면책 조항: 이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 기하기 위해 노력하고 있으나, 자동 번역은 오류나 부정확한 부분이 있을 수 있음을 유의하시기 바랍니다. 원본 문서의 원어본이 권위 있는 자료로 간주되어야 합니다. 중요한 정보의 경우, 전문가의 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.