higress/plugins/wasm-go/mcp-servers/mcp-today-in-history/README_ZH.md

历史上的今天

API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi011517

什么是云市场API MCP服务

阿里云云市场是生态伙伴的交易服务平台，我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务，帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目：应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。 云市场API依托Higress提供MCP服务，您只需在云市场完成订阅并获取AppCode，通过Higress MCP Server进行配置，即可无缝集成云市场API服务。

如何在使用云市场API MCP服务

1. 进入API详情页，订阅该API。您可以优先使用免费试用。
2. 前往云市场用户控制台，使用阿里云账号登陆后查看已订阅API服务的AppCode，并配置到Higress MCP Server的配置中。注意：在阿里云市场订阅API服务后，您将获得AppCode。对于您订阅的所有API服务，此AppCode是相同的，您只需使用这一个AppCode即可访问所有已订阅的API服务。
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度，如您免费试用额度已用完，您可以选择重新订阅。

MCP服务器功能与工具简介

功能简介

本MCP服务器项目名为“today-in-history”，旨在提供历史上的今日相关事件查询服务。通过集成外部API，用户能够获取特定日期或当前日期的历史事件信息，包括但不限于发生的具体事件、相关图片链接以及详细的事件描述等。此服务不仅适用于教育领域作为学习资源，也适合于新闻媒体行业制作专题报道时使用。

工具简介

历史上的今天

• 用途：该工具允许用户查询指定日期内发生的重大历史事件。它支持按需加载更详尽的事件背景资料。
• 使用场景：
  • 教育机构可以利用这一工具来丰富课堂教学内容，增加学生对历史的兴趣。
  • 新闻网站或应用程序可以在每天展示一些有趣的历史事实，吸引读者关注。
  • 个人用户也可以通过这个工具探索过去的日子中发生了哪些重要的事情。

参数说明

• date (字符串类型, 位置: 查询参数)
  • 描述：查询的具体日期。如果不填写，则默认为当前日期。
• needContent (字符串类型, 位置: 查询参数)
  • 描述：是否需要返回事件详情。设置为"1"表示需要，"0"则不需要。

请求模板

• URL: https://today15.market.alicloudapi.com/today-of-history
• 方法: GET
• 请求头:
  • Authorization: 使用配置文件中的appCode值进行身份验证。
  • X-Ca-Nonce: 自动生成的唯一标识符以保证每次请求的独特性。

响应结构

响应将以JSON格式返回，并包含以下主要部分：

• showapi_res_body (对象): 包含实际的数据信息
  • list (数组): 一系列历史事件条目
    • content (字符串): 如果设置了needContent=1，则会显示事件的具体内容。
    • day (整数): 事件发生的日
    • img (字符串): 相关图片的链接
    • month (整数): 月份
    • title (字符串): 事件标题
    • year (字符串): 年份
  • ret_code (整数): 返回的状态码，0代表成功
• showapi_res_code (整数): 整体响应状态码，同样地，0意味着请求处理成功
• showapi_res_error (字符串): 出现错误时提供的错误消息；若无误，则为空

以上即为“today-in-history”MCP服务器及其核心工具的基本介绍。希望这些信息能够帮助您更好地理解和使用这项服务！