返回 MCP 目录
public公开dns本地运行

amanasmuei_mcp-server-malaysia-prayer-time

马来西亚祈祷时间MCP服务器,提供基于官方API的祈祷时间查询服务,支持按区域获取时间、列出所有区域及查询当前祈祷状态。

article

README

🚀 马来西亚祈祷时间 MCP 服务器

本项目是一个基于 Model Context Protocol(MCP)协议的服务器,它借助 github.com/mptwaktusolat/api-waktusolat 的 API,为用户提供马来西亚祈祷时间的数据接口。

🚀 快速开始

本服务器提供了便捷的方式来获取马来西亚祈祷时间相关数据,以下为你详细介绍使用前的准备工作。

✨ 主要特性

  • 获取特定区域的祈祷时间:可精准获取指定区域的祈祷时间。
  • 列出所有可用的祈祷时间区域:方便用户了解所有可查询的区域。
  • 获取某个区域当前的祈祷时间状态:实时掌握特定区域当下的祈祷时间状态。

📦 安装指南

创建虚拟环境并安装依赖项

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

使服务器文件可执行

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

💻 使用示例

在 Claude Desktop 中运行

配置文件添加

将以下配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中:

{
  "mcpServers": {
    "waktu-solat": {
      "command": "uvx",
      "args": ["run", "/绝对路径/to/bin/mcp-server-waktu-solat"],
      "env": {}
    }
  }
}

请将 /绝对路径/to/ 替换为你实际克隆该仓库的路径。

重启加载配置

重启 Claude Desktop 以加载新的 MCP 服务器配置。

可用的 MCP 工具

基础用法

以下为你介绍服务器实现的基础工具使用方法:

# get_prayer_times:获取特定区域的祈祷时间
# 输入:`zone`(字符串)- 区域代码(例如,'SGR01','KUL01')

# list_zones:列出马来西亚所有可用的祈祷时间区域
# 无输入要求

# get_current_prayer:获取某个区域当前的祈祷时间状态
# 输入:`zone`(字符串)- 区域代码(例如,'SGR01','KUL01')

📚 详细文档

开发步骤

克隆仓库

首先,将项目仓库克隆到本地。

安装开发依赖项

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

运行服务器

./bin/mcp-server-waktu-solat

📄 许可证

查看 LICENSE 文件以了解项目的许可信息。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端