AI istemcilerini US National Weather Service API'sine bağlayarak hava durumu tahminleri ve uyarıları sağlar.
Ayrıca bilinen adı dingw1982/quickstart-resources, quickstart-resources, @dingw1982/mcp-quickstart-ts
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- 116
- En son sürüm
- 1.0.1
- Son commit
- 9 Eyl 2026
- Lisans
- —
Weather MCP nedir?
AI istemcilerini US National Weather Service API'sine bağlayarak hava durumu tahminleri ve uyarıları sağlar.
Özet, projenin README dosyasından oluşturuldu
Weather MCP sunucusu hakkında
Bu sunucu, bir yapay zeka asistanı aracılığıyla US National Weather Service verilerine erişmenizi sağlar. Meteorolojik verileri almak için belirli araçlar sunarak LLM istemcileri ile resmi hava durumu bilgileri arasında bir köprü kurar. Geliştiriciler bunu, güncel hava koşullarını ve güvenlik uyarılarını anlayan sohbet botları oluşturmak için kullanabilirler.
Sunucu stdio üzerinden çalışır ve Python, TypeScript, Go, Rust ve Ruby dahil olmak üzere birden fazla uygulamada mevcuttur. İki temel araç sağlar: get_forecast ve get_alerts. Sağlanan örnek istemcileri kullanmak için sohbet döngüsünü çalıştırmak amacıyla bir ANTHROPIC_API_KEY gereklidir, ancak sunucu bağlantısı kimlik bilgisi olmadan doğrulanabilir.
Bu proje, Model Context Protocol için işlevsel bir örnek teşkil eder. Bir yapay zekanın araçları çağırmasına ve yapılandırılmış sonuçlar almasına olanak tanımak için bir istemcinin bir sunucuya nasıl bağlanacağını gösterir. Kullanıcılar farklı dilleri bir arada kullanabilirler; örneğin bir TypeScript sunucusunu yönetmek için Python istemcisi kullanabilirler.
Neler yapabilirsiniz
- 1MCP araç bağlantısını doğrulayınBir API anahtarına ihtiyaç duymadan istemci ve sunucu arasındaki bağlantıyı test edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Weather MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWeather MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources -- npx -y @dingw1982/mcp-quickstart-tsWeather MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}Weather MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"quickstart-resources": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}Weather MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"quickstart-resources","type":"stdio","command":"npx","args":["-y","@dingw1982/mcp-quickstart-ts"],"env":{"YOUR_API_KEY":"<YOUR_YOUR_API_KEY>"}}'Weather MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}Weather MCP'yi Codex içine yükleyin
$ codex mcp add quickstart-resources --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' -- npx -y @dingw1982/mcp-quickstart-tsWeather MCP'yi Codex config.toml içine yükleyin
~/.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>"
Weather MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources npx -- -y @dingw1982/mcp-quickstart-tsWeather MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"quickstart-resources": {
"command": "npx",
"args": [
"-y",
"@dingw1982/mcp-quickstart-ts"
],
"env": {
"YOUR_API_KEY": "<YOUR_YOUR_API_KEY>"
}
}
}
}Yapılandırma
YOUR_API_KEYGerekliGizliYour API key for the service
| Ad | Açıklama | Sunucu |
|---|---|---|
| YOUR_API_KEY | Your API key for the service | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirdingw1982/quickstart-resources is public and reachablegithub.com/dingw1982/quickstart-resources ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@dingw1982/mcp-quickstart-ts names dingw1982/quickstart-resources as sourcenpmjs.com/package/@dingw1982/mcp-quickstart-ts ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-09github.com/dingw1982/quickstart-resources ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @dingw1982/mcp-quickstart-tsGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok4 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
Weather MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'YOUR_API_KEY=<YOUR_YOUR_API_KEY>' quickstart-resources -- npx -y @dingw1982/mcp-quickstart-ts komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Weather MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Hava durumu sunucusu hangi araçları sunar?
Sunucu iki araç sunar: get_forecast ve get_alerts.
İstemcinin araçları listelemek için bir API anahtarına ihtiyacı var mı?
Hayır, MCP bağlantısını doğrulayabilir ve araçları kimlik bilgisi olmadan listeleyebilirsiniz; ancak tam operasyon için bir ANTHROPIC_API_KEY gereklidir.
İstemci ve sunucu için farklı diller kullanabilir miyim?
Evet, dilleri karıştırıp kullanabilirsiniz; örneğin bir TypeScript sunucusunu çalıştırmak için Python istemcisi kullanabilirsiniz.