US National Weather Service APIをAIクライアントに接続し、天気予報や警報を提供します。
別名 dingw1982/quickstart-resources, quickstart-resources, @dingw1982/mcp-quickstart-ts
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- 116
- 最新バージョン
- 1.0.1
- 最終コミット
- 2026年9月9日
- ライセンス
- —
Weather MCPとは
US National Weather Service APIをAIクライアントに接続し、天気予報や警報を提供します。
プロジェクトのREADMEから生成された概要
Weather MCP server について
このserverは、AIアシスタントを通じてUS National Weather Serviceのデータにアクセスすることを可能にします。気象データを取得するための特定のツールを公開することで、LLMクライアントと公式の気象情報との架け橋となります。開発者はこれを利用して、現在の天候状況や安全に関する警告を理解できるチャットボットを構築できます。
このserverはstdio経由で動作し、Python、TypeScript、Go、Rust、Rubyを含む複数の実装が利用可能です。主なツールとして、get_forecastとget_alertsの2つを提供しています。提供されているサンプルクライアントを使用する場合、チャットループを動作させるためにANTHROPIC_API_KEYが必要ですが、serverへの接続確認自体は認証なしで行えます。
このプロジェクトは、Model Context Protocolの機能的な例として機能します。クライアントをserverに接続し、AIがツールを呼び出して構造化された結果を受け取る仕組みを実証しています。ユーザーは、PythonクライアントからTypeScript serverを操作するなど、異なる言語を自由に組み合わせて使用できます。
できること
- 1MCPツールの接続確認APIキーを必要とせずに、クライアントとserver間の接続をテストします。
プロジェクトの 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
このweather serverはどのようなツールを提供していますか?
このserverは、get_forecastとget_alertsの2つのツールを提供しています。
ツールをリスト表示するためにクライアントにAPIキーは必要ですか?
いいえ、認証なしでMCPの接続確認やツールのリスト表示が可能です。ただし、すべての機能を利用するにはANTHROPIC_API_KEYが必要です。
クライアントとserverで異なる言語を使用できますか?
はい、可能です。例えば、PythonクライアントからTypeScript serverを操作するといった組み合わせができます。