关键词

伊朗日历时间日期事件网络爬虫

使用说明

项目简介

TimeIrCrawler MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端，旨在为LLM客户端提供伊朗时间、日期和日历事件等上下文信息。它通过网络爬虫技术从time.ir网站获取数据，并以MCP协议标准化的方式提供服务。

主要功能点

  • 获取当前时间数据：提供当前时间（时:分:秒）、波斯/Shamsi日历日期、伊斯兰历日期和公历日期。
  • 获取当月事件和节假日：抓取并返回伊朗日历当月的事件和节假日信息。
  • MCP服务器集成：实现了MCP服务器协议，可以与支持MCP协议的LLM客户端无缝集成。
  • 数据获取失败回退：当网络爬虫无法获取数据时，使用系统时间作为后备数据源，保证服务的可用性。

安装步骤

  1. 克隆仓库

    git clone https://github.com/pooya1380m/TimeIrCrawler_Mcp
cd TimeIrCrawler_Mcp

  2. 构建项目 确保已安装 .NET 9.0 SDK。在项目根目录下运行：

    dotnet build

  3. 运行服务器 构建成功后，在项目根目录下运行：

    dotnet run --project TimeIrCrawler/TimeIrCrawler.csproj

    或者，如果您想运行不带TimeIrCrawler功能的EchoTool示例服务器（用于测试MCP客户端连接），可以运行根目录下的 'Program.csproj'：

    dotnet run

服务器配置

MCP客户端需要配置 'mcp.json' 文件以连接到 TimeIrCrawler MCP服务器。以下是一个示例配置，请根据实际情况修改路径：

{
  "timeir": {
    "command": "dotnet",
    "args": [
      "/path/to/TimeIrCrawler_Mcp/TimeIrCrawler/bin/Debug/net9.0/TimeIrCrawler.dll"
    ],
    "label": "Time.ir Time Provider",
    "description": "提供来自time.ir网站的伊朗时间、日期和事件信息"
  }
}

配置参数说明:

  • command: 运行MCP服务器的命令，这里使用 'dotnet' 运行 .NET DLL。
  • args: 传递给 'dotnet' 命令的参数，指定了 TimeIrCrawler 服务器 DLL 文件的路径。请务必将 '/path/to/TimeIrCrawler_Mcp' 替换为您的本地仓库路径。

基本使用方法

配置完成后，MCP客户端即可通过配置的 'timeir' 服务与 TimeIrCrawler MCP服务器建立连接。客户端可以使用以下工具 (Tools) 获取数据：

  • GetCurrentTimeData: 获取当前时间、波斯日历日期、伊斯兰历日期和公历日期。
  • GetEventsDataAsync: 获取当月伊朗日历的事件和节假日列表。

具体工具调用方法请参考您的MCP客户端软件的使用说明。客户端通常会提供界面或命令来调用这些工具，并将返回的数据展示给用户或用于后续的LLM交互。

信息

分类

网页与API

访问项目