first commit

examples/mcps/temperature/README.md

@@ -0,0 +1,105 @@
+# Temperature MCP Server
+
+A simple Model Context Protocol (MCP) server that provides temperature information for popular cities around the world. This server exposes a single tool `get_temperature` that returns dummy temperature data for demonstration purposes.
+
+## Features
+
+- Single MCP tool: `get_temperature`
+- Supports 20+ popular cities worldwide
+- Returns temperature in Celsius or Fahrenheit
+- Includes weather conditions
+- Uses dummy/mock data (no external API calls)
+
+## Installation
+
+```bash
+npm install
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Usage
+
+### Running the Server
+
+The server runs on stdio transport (standard input/output) by default:
+
+```bash
+npm start
+```
+
+### Using with MCP Clients
+
+This server can be used with any MCP-compatible client. Add it to your client configuration:
+
+```json
+{
+  "mcpServers": {
+    "temperature": {
+      "command": "node",
+      "args": ["/path/to/temperature-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Available Tool
+
+#### get_temperature
+
+Get the current temperature for a popular city.
+
+**Input:**
+- `location` (string, required): The name of the city
+
+**Example:**
+```json
+{
+  "location": "New York"
+}
+```
+
+**Output:**
+```
+Temperature in New York: 72°F
+Condition: Partly Cloudy
+```
+
+## Supported Cities
+
+The server provides temperature data for the following cities:
+
+- New York, Los Angeles, San Francisco, Chicago (USA)
+- London, Paris, Berlin, Moscow (Europe)
+- Tokyo, Beijing, Shanghai, Hong Kong, Seoul, Singapore (Asia)
+- Sydney (Australia)
+- Dubai (Middle East)
+- Mumbai (India)
+- Toronto (Canada)
+- Mexico City (Mexico)
+- Rio de Janeiro (Brazil)
+
+## Development
+
+To run in development mode:
+
+```bash
+npm run dev
+```
+
+## Architecture
+
+This server demonstrates:
+- TypeScript MCP server implementation
+- Tool registration and execution
+- Input validation using Zod
+- Stdio transport for communication
+- Error handling and user-friendly messages
+
+## Note
+
+This server uses dummy data for demonstration purposes. In a production environment, you would integrate with a real weather API service.