Pelayan MCP

Sambungkan Claude, ChatGPT, Cursor atau pembantu AI lain kepada solat.my melalui Model Context Protocol. Pembantu AI anda boleh menyemak waktu solat, arah kiblat, masjid dan Panduan Solat terus dalam perbualan. Percuma, tanpa akaun dan tanpa kunci API. Semua alat hanya membaca data.

Alamat Pelayan

https://mcp.solat.my

Pelayan ini menggunakan Streamable HTTP melalui HTTPS. Anda tidak perlu memasang sebarang pakej.

Cara Menyambung

Claude Code

Jalankan arahan ini dalam terminal:

claude mcp add --transport http solat https://mcp.solat.my

Claude, ChatGPT dan aplikasi lain yang menyokong connector

Tambah custom connector baharu, kemudian masukkan URL https://mcp.solat.my.

Cursor, Windsurf dan aplikasi lain yang menggunakan mcp.json

Tambah blok ini ke dalam fail mcp.json:

{
  "mcpServers": {
    "solat": { "url": "https://mcp.solat.my" }
  }
}

Cuba dengan curl

Hantar permintaan JSON-RPC terus kepada pelayan:

curl -sS https://mcp.solat.my \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Senarai Alat

Alat	Parameter	Hasil
`list_prayer_zones`	state?, include_locations?	Semua 59 kod zon, mengikut negeri
`find_prayer_zone`	query, atau latitude + longitude	Senarai zon yang sepadan, yang paling tepat dahulu
`get_prayer_times`	zone, date?	Waktu solat untuk sehari, termasuk waktu solat berikutnya
`get_monthly_prayer_times`	zone, year?, month?	Waktu solat sebulan (bulan Masihi)
`get_prayer_times_range`	zone, start_date, end_date	Waktu solat antara dua tarikh, sehingga 62 hari
`get_qibla_direction`	latitude + longitude, atau query	Arah kiblat dalam darjah, diukur dari utara benar
`find_mosques`	query?, state?, category?, latitude + longitude?, page?	Carian masjid dan surau, 20 hasil bagi setiap halaman
`search_prayer_guide`	query, book?	Carian Panduan Solat mengikut kata kunci
`get_prayer_guide_page`	book, page?	Isi penuh satu bahagian Panduan beserta rujukan, atau senarai kandungan buku

Alat waktu solat menggunakan kod zon seperti SGR01. Pembantu AI akan memanggil find_prayer_zone dahulu untuk mendapatkan kod zon daripada nama tempat.

Untuk Panduan Solat, gunakan kata kunci Bahasa Melayu seperti sujud sahwi atau solat atas kerusi.

Waktu dipaparkan dalam format 24 jam (HH:MM), mengikut waktu Malaysia (UTC+08:00). Nama waktu solat kekal dalam Bahasa Melayu: subuh, zohor, asar, maghrib dan isyak.

Had penggunaan ialah 120 permintaan seminit bagi setiap alamat IP. Had ini berasingan daripada had API JSON.

Waktu solat diambil terus daripada JAKIM. solat.my tidak mengira atau mengubah waktu tersebut. solat.my bukan laman web kerajaan.

Arah kiblat diukur dari utara benar. Kompas telefon biasanya menunjukkan utara magnet, jadi bacaannya mungkin berbeza sedikit.

Senarai masjid diambil dari pelbagai sumber. Senarai ini belum lengkap dan sesetengah maklumatnya mungkin tidak tepat.