MCP Demo

一个使用DeepSeek-V3模型的MCP演示项目，通过命令行交互查询天气信息，支持获取警报和天气预报功能。

人工智能聊天机器人位置服务 #天气查询 #命令行工具 #LLM应用 .Python

评分 : 2分

下载量 : 11

更新时间 : 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 ForecastProvides detailed weather forecasts including temperature, wind conditions, and sky conditions for locations worldwide

Weather AlertsCan check for active weather alerts and warnings in specified locations

Natural Language InterfaceUnderstands and responds to natural language queries about weather conditions

Pros and Cons

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 QueryGetting the current weather forecast for a major city

Multi-day ForecastRequesting weather information for multiple days

Weather Alerts CheckChecking 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: