Amanasmuei MCP Server Malaysia Prayer Time

🚀 Malaysia Prayer Time MCP Server

A server based on the Model Context Protocol (MCP) that provides an interface for Malaysia prayer time data, utilizing the API from github.com/mptwaktusolat/api-waktusolat.

🚀 Quick Start

This server offers interfaces to access Malaysia prayer time data. It's built on the MCP protocol and fetches data from a specific API.

✨ Features

• Retrieve prayer times for a specific zone.
• List all available prayer time zones.
• Get the current prayer time status for a zone.

📦 Installation

1. Create a virtual environment and install dependencies:

uv venv
source .venv/bin/activate
uv pip install -e .

2. Make the server file executable:

chmod +x bin/mcp-server-waktu-solat

💻 Usage Examples

Run in Claude Desktop

1. Add the following configuration to the ~/Library/Application Support/Claude/claude_desktop_config.json file:

{
  "mcpServers": {
    "waktu-solat": {
      "command": "uvx",
      "args": ["run", "/absolute/path/to/bin/mcp-server-waktu-solat"],
      "env": {}
    }
  }
}

Replace /absolute/path/to/ with the actual path where you cloned the repository.

2. Restart Claude Desktop to load the new MCP server configuration.

Available MCP Tools

Here are the tools implemented by the server:

get_prayer_times

Retrieve prayer times for a specific zone.

• Input: zone (string) - Zone code (e.g., 'SGR01', 'KUL01')

list_zones

List all available prayer time zones in Malaysia.

• No input required.

get_current_prayer

Get the current prayer time status for a zone.

• Input: zone (string) - Zone code (e.g., 'SGR01', 'KUL01')

🚧 Development

1. Clone the repository.
2. Install development dependencies:

uv venv
source .venv/bin/activate
uv pip install -e .

3. Run the server:

./bin/mcp-server-waktu-solat

📄 License

See the LICENSE file.