🚀 马来西亚祈祷时间 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 文件以了解项目的许可信息。