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 文件以了解项目的许可信息。
微信扫一扫