Advertise
MCP.so
Sign In

MCP Demo

@guobinqiu

Repository

Basic information

Category

Other

Transports

stdio

Author

guobinqiu

About MCP Demo

测试 mcp client 通过 deepseek 连接 mcp server 获取天气预报

#mcp#demo#weather-forecast

MCP Demo config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

MCP Demo tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Demo?

MCP Demo is a demonstration MCP (Model Context Protocol) server that provides weather forecasts and alerts from the U.S. National Weather Service. It is designed for use with language models like DeepSeek-V3 (deepseek-chat) that support the tools attribute.

How to use MCP Demo?

Clone the repository, create a Python virtual environment with uv, and set your OPENAI_API_KEY in a .env file. Run the client with python client/main.py server/main.py. The client accepts natural language queries about weather.

Key features of MCP Demo

  • Provides two tools: get_alerts and get_forecast
  • Uses the free National Weather Service API (api.weather.gov)
  • Requires DeepSeek-V3 model (deepseek-chat) for tool support
  • Written in Python, with a Golang version also available
  • Simple client-server architecture over stdio

Use cases of MCP Demo

  • Get current weather forecast for any U.S. city
  • Retrieve weather alerts for a given location
  • Demonstrate MCP integration with an LLM

Frequently asked questions

1

What tools are available?

Two tools: `get_alerts` and `get_forecast`.

2

How do I install and run it?

Install `uv`, clone the repo, create a virtual environment, and run `python client/main.py server/main.py`. Set your `OPENAI_API_KEY` in a `.env` file first.

3

Which LLM does this demo work with?

It works with `deepseek-chat` (DeepSeek-V3) because only V3 has the `tools` attribute. Other models like `deepseek-reasoner` are not supported.

4

Do I need any API keys?

Yes, you need an OpenAI API key (though the demo queries the NWS API, not OpenAI). Set it in the `.env` file.

5

Where does the weather data come from?

The data comes from the public U.S. National Weather Service API at `https://api.weather.gov`.

Comments

More Other MCP servers

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Advertise