README.md•1.72 kB
# 🧠 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"
}
}
]
}
```