US National Weather Service API를 AI 클라이언트에 연결하여 기상 예보와 경보를 제공합니다.
다른 이름 dingw1982/quickstart-resources, quickstart-resources, @dingw1982/mcp-quickstart-ts
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 116
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 9월 9일
- 라이선스
- —
Weather MCP란?
US National Weather Service API를 AI 클라이언트에 연결하여 기상 예보와 경보를 제공합니다.
프로젝트 README에서 생성된 요약
Weather MCP server 정보
이 서버를 사용하면 AI 어시스턴트를 통해 US National Weather Service 데이터를 확인할 수 있습니다. 기상 데이터를 가져오기 위한 특정 도구를 노출함으로써 LLM 클라이언트와 공식 기상 정보 사이의 가교 역할을 합니다. 개발자는 이를 활용하여 현재 날씨 상태와 안전 경보를 이해하는 챗봇을 구축할 수 있습니다.
서버는 stdio를 통해 작동하며 Python, TypeScript, Go, Rust, Ruby 등 다양한 구현체를 지원합니다. 주요 도구로는 get_forecast와 get_alerts가 있습니다. 제공된 예제 클라이언트를 사용하려면 채팅 루프 구동을 위한 ANTHROPIC_API_KEY가 필요하지만, 서버와의 연결 자체는 인증 없이도 확인 가능합니다.
이 프로젝트는 Model Context Protocol의 기능적 예시 역할을 합니다. 클라이언트를 서버에 연결하여 AI가 도구를 호출하고 구조화된 결과를 받는 방법을 보여줍니다. 사용자는 Python 클라이언트로 TypeScript 서버를 제어하는 등 서로 다른 언어를 자유롭게 조합할 수 있습니다.
활용 사례
- 1MCP 도구 연결 확인API 키 없이 클라이언트와 서버 간의 연결을 테스트합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Weather MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Weather MCP 설치
$ claude mcp add --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources -- npx -y @dingw1982/mcp-quickstart-tsCursor에 Weather MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}VS Code에 Weather MCP 설치
.vscode/mcp.json
{
"servers": {
"quickstart-resources": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}VS Code CLI에 Weather MCP 설치
$ code --add-mcp '{"name":"quickstart-resources","type":"stdio","command":"npx","args":["-y","@dingw1982/mcp-quickstart-ts"],"env":{"YOUR_API_KEY":"<YOUR_YOUR_API_KEY>"}}'Claude Desktop에 Weather MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}Codex에 Weather MCP 설치
$ codex mcp add quickstart-resources --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-tsCodex config.toml에 Weather MCP 설치
~/.codex/config.toml
[mcp_servers.quickstart-resources] command = "npx" args = ["-y", "@dingw1982/mcp-quickstart-ts"] [mcp_servers.quickstart-resources.env] YOUR_API_KEY = "<YOUR_YOUR_API_KEY>"
Gemini CLI에 Weather MCP 설치
$ gemini mcp add -s user -e 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources npx -- -y @dingw1982/mcp-quickstart-tsGemini settings.json에 Weather MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}구성
YOUR_API_KEY필수비밀Your API key for the service
| 이름 | 설명 | 유형 |
|---|---|---|
| YOUR_API_KEY | Your API key for the service | 필수비밀 |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능dingw1982/quickstart-resources is public and reachablegithub.com/dingw1982/quickstart-resources ↗통과
- 패키지가 이 저장소를 소스로 명시@dingw1982/mcp-quickstart-ts names dingw1982/quickstart-resources as sourcenpmjs.com/package/@dingw1982/mcp-quickstart-ts ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-09github.com/dingw1982/quickstart-resources ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @dingw1982/mcp-quickstart-ts통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음4 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기MCP Quickstart Resources
Example servers and clients for the Model Context Protocol (MCP), in five languages. These are companion examples for two official tutorials:
- Build an MCP server – a simple MCP weather server exposing two tools backed by the US National Weather Service API
- Build an MCP client – an LLM-powered chatbot MCP client that connects to any stdio server and lets Claude call its tools
What's in this repository
Each example lives in its own directory with its own README covering prerequisites, setup, and how to run it:
| Language | Weather server (MCP server) | Chatbot (MCP client) |
|---|---|---|
| Python | weather-server-python |
mcp-client-python |
| TypeScript | weather-server-typescript |
mcp-client-typescript |
| Go | weather-server-go |
mcp-client-go |
| Rust | weather-server-rust |
mcp-client-rust |
| Ruby | weather-server-ruby |
mcp-client-ruby |
All servers communicate over stdio and expose the same two tools: get_forecast and get_alerts (or get-forecast and get-alerts in TypeScript).
All clients launch a server, list its tools, and start an interactive chat loop in which Claude can call those tools. The Python, TypeScript, and Ruby clients take a path to a server script; the Go and Rust clients take the command to run, plus any arguments.
Note: These example clients need an ANTHROPIC_API_KEY to operate. Without a key, each client still connects and lists the server's tools before exiting, so you can verify the MCP wiring without credentials.
You can mix and match across languages: for example, the Python client can drive the TypeScript server. Each client's README lists which server launch forms it supports.
The tests directory contains the smoke tests that run in CI against these examples. See tests/README.md for how they work.
Prerequisites
Each example only needs its own language toolchain. To work across the whole repository (for example, to run the smoke tests) you need:
- Node.js 24+ and npm
- Python 3.10+ and uv
- Go 1.25+
- Rust 1.88+ and Cargo
- Ruby 3.4+ and Bundler
Running the tests
./tests/smoke-test.sh
The smoke tests verify that every server starts and answers MCP requests (including validating structured tool results against the schemas each tool advertises), and that the Python, TypeScript, and Ruby clients can connect to a mock server and list tools. They run automatically on every pull request via GitHub Actions.
Contributing
Contributions are welcome. To submit a change:
- Fork the repository and create a branch from
main. - Make your change. Keep the examples minimal - they exist to teach the protocol, not to be production services.
- If you change an example's behavior, setup, or dependencies, update that example's README to match.
- Run
./tests/smoke-test.shand make sure it passes. - Open a pull request against
maindescribing what changed and why.
A few conventions to follow, in line with the broader Model Context Protocol contributing guidelines:
- Keep documentation clear, concise, and technically accurate. Include code examples where appropriate, and test the commands and links you add.
- Disclose AI assistance. If you used any kind of AI assistance to prepare your contribution, say so in the pull request or issue. See AI_POLICY.md for what the disclosure should cover.
- Be respectful. This project follows the MCP community's Code of Conduct. Concerns can be reported to mcp-coc@anthropic.com.
Security note
These examples are intentionally minimal. If you expose an MCP server over a network (HTTP/SSE/WebSocket), add authentication and basic hardening (CORS allowlist, request size limits, timeouts, rate limits, and log redaction). See SECURITY.md.
License
The MCP project is transitioning from the MIT License to Apache-2.0. New code contributions are licensed under Apache-2.0, and documentation (excluding specifications) under CC-BY-4.0. Earlier contributions whose authors have not consented to relicensing remain under the MIT License. See LICENSE for the full terms.
Weather MCP 질문
Weather MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources -- npx -y @dingw1982/mcp-quickstart-ts를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Weather MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
weather server는 어떤 도구를 제공하나요?
이 서버는 get_forecast와 get_alerts 두 가지 도구를 제공합니다.
도구 목록을 확인하기 위해 클라이언트에 API 키가 필요한가요?
아니요, 인증 없이도 MCP 연결을 확인하고 도구 목록을 불러올 수 있습니다. 다만, 전체 기능을 사용하려면 ANTHROPIC_API_KEY가 필요합니다.
클라이언트와 서버에 서로 다른 언어를 사용할 수 있나요?
네, Python 클라이언트로 TypeScript 서버를 구동하는 것과 같이 다양한 언어를 조합하여 사용할 수 있습니다.