MCP Demo

一個使用DeepSeek-V3模型的MCP演示項目，通過命令行交互查詢天氣信息，支持獲取警報和天氣預報功能。

人工智能聊天機器人位置服務 #天氣查詢 #命令行工具 #LLM應用 .Python

評分 : 2分

下載量 : 7.6K

更新時間 : 2025-04-29

打開站點

What is MCP Demo Server?

The MCP Demo Server is a practical implementation of the Model Context Protocol that connects language models with external tools. This specific demo provides weather forecasting capabilities by integrating with the National Weather Service API.

How to use the MCP Demo Server?

You can interact with the server through a simple client interface that sends natural language queries about weather conditions. The system will automatically determine the appropriate weather data to retrieve and present it in an easy-to-understand format.

Use Cases

Ideal for checking current weather conditions, planning outdoor activities, or integrating weather data into other applications through natural language queries.

Key Features

Weather Forecast

Provides detailed weather forecasts including temperature, wind conditions, and sky conditions for locations worldwide

Weather Alerts

Can check for active weather alerts and warnings in specified locations

Natural Language Interface

Understands and responds to natural language queries about weather conditions

Advantages

Easy-to-use natural language interface

Provides comprehensive weather information from reliable sources

Can handle complex queries about weather conditions

Quick response time for weather data

Limitations

Limited to weather-related queries only

Requires an API key for DeepSeek integration

Accuracy depends on the underlying weather data sources

Currently only supports English queries

Getting Started

Set up your environment

Install the required dependencies and create a virtual environment

Install required packages

Add the necessary Python packages including MCP and its dependencies

Configure API key

Add your DeepSeek API key to the .env file

Run the client

Start interacting with the weather service through the client interface

Example Queries

Basic Weather Query

Getting the current weather forecast for a major city

Multi-day Forecast

Requesting weather information for multiple days

Weather Alerts Check

Checking for severe weather alerts

Frequently Asked Questions

What weather data sources does this use?

Do I need a DeepSeek API key?

Can I use this with other LLMs besides DeepSeek?

What locations are supported?

How accurate is the weather data?

Additional Resources

MCP Documentation

Official documentation for Model Context Protocol

National Weather Service API

Documentation for the weather data API used by this demo

DeepSeek API

Information about the DeepSeek language model API

Example Repository

Source code for this demonstration project

🚀 MCP 項目

本項目是一個基於特定框架的應用，可用於查詢天氣等信息，藉助相關工具和 API 實現數據交互與處理。

🚀 快速開始

📦 安裝指南

按照以下步驟進行項目的安裝：

uv init mcp-demo
cd mcp-demo
uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx
uv add mcp openai python-dotenv
rm main.py

💻 使用示例

運行項目

在運行項目前，請將 .env 文件裡的 OPENAI_API_KEY 替換為你的 deepseek api key。

python3 client.py weather.py

輸出示例

運行項目後，會有如下輸出信息：

[04/23/25 21:11:54] INFO     Processing request of type ListToolsRequest                                                                                 server.py:534

Connected to server with tools: ['get_alerts', 'get_forecast']

MCP 客戶端已啟動！
輸入你的查詢或輸入'quit'退出。

Query: 紐約的天氣如何？
[04/23/25 21:12:09] INFO     Processing request of type ListToolsRequest                                                                                 server.py:534
[04/23/25 21:12:15] INFO     Processing request of type CallToolRequest                                                                                  server.py:534
                    INFO     HTTP Request: GET https://api.weather.gov/points/40.7128,-74.006 "HTTP/1.1 200 OK"                                        _client.py:1740
[04/23/25 21:12:16] INFO     HTTP Request: GET https://api.weather.gov/gridpoints/OKX/33,35/forecast "HTTP/1.1 200 OK"                                 _client.py:1740
[DEBUG] final_text[0] type: <class 'str'>, value: 紐約當前天氣預報如下：

### 今天：
- **溫度**：73°F  
- **風速**：7 mph NW  
- **預報**：大部分時間晴朗，最高氣溫約為73。

### 今晚：
- **溫度**：57°F  
- **風速**：3到7 mph SE  
- **預報**：大部分時間晴朗。

### 明天：
- **溫度**：68°F（下午會降至64°F）  
- **風速**：3到12 mph SE  
- **預報**：晴朗。

### 明晚：
- **溫度**：56°F  
- **風速**：6到12 mph S  
- **預報**：大部分時間晴朗。

### 後天：
- **溫度**：70°F（下午會降至66°F）  
- **風速**：5到14 mph S  
- **預報**：部分多雲。

如有需要，可以告訴我提供更多細節！

紐約當前天氣預報如下：

### 今天：
- **溫度**：73°F  
- **風速**：7 mph NW  
- **預報**：大部分時間晴朗，最高氣溫約為73。

### 今晚：
- **溫度**：57°F  
- **風速**：3到7 mph SE  
- **預報**：大部分時間晴朗。

### 明天：
- **溫度**：68°F（下午會降至64°F）  
- **風速**：3到12 mph SE  
- **預報**：晴朗。

### 明晚：
- **溫度**：56°F  
- **風速**：6到12 mph S  
- **預報**：大部分時間晴朗。

### 後天：
- **溫度**：70°F（下午會降至66°F）  
- **風速**：5到14 mph S  
- **預報**：部分多雲。

如有需要，可以告訴我提供更多細節！

Query: