节假日信息服务

一个提供印度马哈拉施特拉邦节假日信息的模型上下文协议(MCP)服务器,支持节假日数据的获取、缓存、搜索和导出功能。

  • by ShubhamMHingne
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shubhammhingne/mcp-servers

使用说明

马哈拉施特拉邦假期MCP服务器

为马哈拉施特拉邦提供假期信息的模型上下文协议(MCP)服务器。服务器从MMRDA(孟买都市区发展局)网站获取并缓存假期数据。

特性

  • 获取并缓存特定年份的假期数据
  • 按名称、月份或日期范围搜索假期
  • 检查特定日期是否为假日
  • 以ICS或JSON格式导出假期
  • 自动刷新缓存以确保最新的假期信息

安装

您可以通过两种方式使用此MCP服务器:

1.使用Docker

# Pull the image
docker pull shubhammh/maharashtra-holiday-mcp

# Run the container
docker run -i --rm shubhammh/maharashtra-holiday-mcp

2.使用Python

# Install the required package
pip install fastmcp

# Run the server using the python script
python my_mcp_server.py

配置

将以下配置添加到您的 .vscode/mcp.json 文件:

{
  "servers": {
    "maharashtra-holidays": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/my_mcp_server.py"],
      "env": {},
      "envFile": "${workspaceFolder}/.env"
    }
  }
}

用法

服务器提供以下功能:

  1. fetch_holidays(year: Optional[int], force_refresh: bool = False) -获取并缓存假期
  2. find_holidays(year: Optional[int], query: Optional[str], month: Optional[int], range_start: Optional[str], range_end: Optional[str]) -搜索假期
  3. is_holiday(date: str) -检查日期是否为假日
  4. export(year: Optional[int], format: str = "ics") -出口假期

数据源

假期数据来源于 MMRDA公众假期页面.

许可证

MIT许可证