Malaysia Prayer Time MCP Server

Metadata-Version: 2.4 Name: malaysia-prayer-time Version: 0.2.0 Summary: Malaysia Prayer Time UVX Plugin for Claude Desktop Author-email: Your Name <your-email@example.com> Project-URL: Homepage, https://github.com/yourusername/mcp-server-malaysia-prayer-time Project-URL: Bug Tracker, https://github.com/yourusername/mcp-server-malaysia-prayer-time/issues Classifier: Programming Language :: Python :: 3 Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: OS Independent Requires-Python: >=3.8 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: httpx<0.25.0,>=0.24.0 Requires-Dist: pydantic<3.0.0,>=2.0.0 Requires-Dist: PyYAML<7.0,>=6.0 Dynamic: license-file <div align="center"> <img src="public/images/banner.svg" alt="Malaysia Prayer Time MCP Server" width="800"> </div> # Malaysia Prayer Time MCP Server An MCP (Model Context Protocol) server that provides access to Malaysia Prayer Time data using the API from [github.com/mptwaktusolat/api-waktusolat](https://github.com/mptwaktusolat/api-waktusolat). ## Features - Get prayer times for specific zones in Malaysia - List all available prayer time zones - Get current prayer time status for a zone ## Installation ### Option 1: Install as UVX Plugin (Recommended for Claude Desktop) 1. Install the plugin directly from the repository: ```bash pip install git+https://github.com/amanasmuei/mcp-server-malaysia-prayer-time.git ``` 2. The plugin will be automatically registered with Claude Desktop if it supports UVX plugins. ### Option 2: Install as MCP Server 1. Create a virtual environment and install dependencies using uv: ```bash uv venv source .venv/bin/activate uv pip install -e . ``` 2. Make the server executable: ```bash chmod +x bin/mcp-server-waktu-solat ``` ## Usage ### Running with Claude Desktop as UVX Plugin When installed as a UVX plugin, Claude Desktop should automatically detect and load the plugin. You can access the tools directly through Claude without any additional configuration. Example prompts: - "What are the prayer times for KUL01 zone in Malaysia?" - "List all available prayer time zones in Malaysia" - "What is the current prayer time for SGR01 zone?" ### Running in Claude Desktop as MCP Server 1. Add the following configuration to `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "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 this repository. 2. Restart Claude Desktop to load the new MCP server. ### Available Tools The server implements the following tools: ### get_prayer_times Get prayer times for a specific zone in Malaysia - Input: `zone` (string) - The 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 specific zone - Input: `zone` (string) - The zone code (e.g., 'SGR01', 'KUL01') ## Development 1. Clone the repository 2. Install development dependencies: ```bash uv venv source .venv/bin/activate uv pip install -e . ``` 3. Run the server: ```bash ./bin/mcp-server-waktu-solat ``` 4. To test the UVX plugin during development: ```bash uvx run src/uvx_plugin.py ``` ## License See [LICENSE](LICENSE) file.