Skip to main content
Glama
sthossan

Weather & Prayer Times MCP Server

by sthossan
README.md
# 🧠 Node MCP Local Server (TypeScript)

This is a **Model Context Protocol (MCP)** demo server implemented in **Node.js + TypeScript**, running via **STDIO**.

## 🚀 Features

- Tools: Weather & Namaz times
- Prompts: Motivation & Greeting
- Resources: Example Readme
- Sampling: Random quote

## 🧩 Run Locally

```bash
npm install
npm run start
```

### API Keys

- **OpenWeatherMap:**
  - Sign up for a free account at [OpenWeatherMap](https://openweathermap.org/api).
  - Generate your API key.
  - Replace `YOUR_OPENWEATHERMAP_API_KEY` in your `.env` file with this key.
- **Aladhan API:**
  - The [Aladhan API](http://api.aladhan.com/) for namaz timings generally does not require an API key for its public endpoints.

## 📦 Environment

Copy `.env.example` → `.env` and add any API keys (if needed).

    ## ⚙️ Configure your MCP client to spawn the server

For Claude Desktop Add to your claude_desktop_config.json:

```json
{
  "mcpServers": {
    "weather-prayer": {
      "command": "node",
      "args": ["/path/to/your/mcp-server/dist/server.js"],
      "env": {
        "API_KEY": "default-api-key"
      }
    }
  }
}
```

For Cursor Add to your Cursor MCP configuration:

```json
{
  "mcpServers": {
    "weather-prayer": {
      "command": "node",
      "args": ["/path/to/your/mcp-server/dist/server.js"],
      "env": {
        "API_KEY": "default-api-key"
      }
    }
  }
}
```

For ChatGPT If using ChatGPT with MCP support, configure in your MCP settings:

```json
{
  "servers": [
    {
      "name": "weather-prayer",
      "command": "node",
      "args": ["/path/to/your/mcp-server/dist/server.js"],
      "env": {
        "API_KEY": "default-api-key"
      }
    }
  ]
}
```