DummyMCP.Tools 0.1.1-beta

MCP Weather Server Example

This is a dummy Model Context Protocol (MCP) server designed to demonstrate MCP possibilities. It provides real-time weather information by integrating with the OpenWeatherMap API. The server exposes tools for retrieving current weather, weather forecasts, and weather alerts, making it compatible with AI assistants like Claude, GitHub Copilot, and other MCP-compatible clients.

Features

• Current Weather: Retrieves current weather conditions for a specified city, including temperature, humidity, wind, and more.
• Weather Forecast: Provides a 5-day weather forecast for a specified city with detailed hourly data.
• Weather Alerts: Fetches active weather alerts for a specified city, including event details and durations. (Requires extra subscription)
• Configurable API Key: Supports configuration of the OpenWeatherMap API key via environment variables.
• Cross-Platform: Built on .NET 8.0, ensuring compatibility across multiple platforms.
• Integration: Seamlessly works with VS Code, Visual Studio, and other MCP-compatible environments.

Installation

From NuGet (Recommended)

The server is available as a NuGet package at nuget.org/packages/DummyMCP.Tools.

Global Installation

Install the tool globally using:

dotnet tool install --global DummyMCP.Tools

After installation, you can run it directly with the command DummyMCP.

Local Installation

Install the tool locally within your project:

dotnet new tool-manifest
dotnet tool install --local DummyMCP.Tools

Run it using dotnet DummyMCP from the project directory.

From Source

To build and run from the source code:

1. Clone the repository:

git clone https://github.com/ASolomatin/DummyMCP.git
cd DummyMCP

2. Build and run:

dotnet build
dotnet run

Configuration

VS Code Setup

Create a .vscode/mcp.json file in your workspace with the following content (assuming global installation):

{
  "servers": {
    "DummyMcpServer": {
      "type": "stdio",
      "command": "DummyMCP",
      "args": [],
      "env": {
        "DUMMY_OWM__API_KEY": "[Your OpenWeatherMap API Key here]"
      }
    }
  }
}

Visual Studio Setup

Create a .mcp.json file in your solution directory:

{
  "servers": {
    "DummyMcpServer": {
      "type": "stdio",
      "command": "DummyMCP",
      "args": [],
      "env": {
        "DUMMY_OWM__API_KEY": "[Your OpenWeatherMap API Key here]"
      }
    }
  }
}

Local Development Setup

For testing directly from the source code:

{
  "servers": {
    "DummyMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "${workspaceFolder}/DummyMCP/DummyMCP.csproj"],
      "env": {
        "DUMMY_OWM__API_KEY": "[Your OpenWeatherMap API Key here]"
      }
    }
  }
}

Note: You must obtain an API key from OpenWeatherMap to use this server. Sign up on their website, generate an API key, and replace [Your OpenWeatherMap API Key here] with your key.

Environment Variables

Available Tools

The server provides the following tools, as defined in the WeatherTools class:

Tool Parameters

Each tool accepts the following parameters:

• city: The name of the city (required). Must contain only letters, spaces, or hyphens.
• countryCode: Optional two-letter country code (e.g., "US", "UK") in uppercase.

Error Handling

The tools include validation and error handling:

• Invalid city names or country codes return descriptive error messages.
• If a city is not found, the response indicates "City not found."
• API errors or connectivity issues are logged and returned as user-friendly messages.

Additional Notes

• The server uses .NET 8.0 and the OpenWeatherMap .NET client library for robust API interactions.
• Responses are formatted as readable strings, making them suitable for both human users and AI clients.
• Logging is implemented to track requests and errors, aiding in debugging during development.