AI导哈

全球新闻搜索服务

提供对GDELT DOC 2.0 API的访问，用于搜索全球新闻文章和图像。

  • by MissionSquad
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MissionSquad/mcp-gdelt

使用说明

GDELT MCP 服务器

一个模型上下文协议（MCP）服务器，提供访问GDELT DOC 2.0 API的权限，用于搜索全球新闻文章和图片。

特点/功能

  • 搜索文章在全球65种语言的新闻报道中进行搜索（滚动窗口为3个月）
  • 搜索图片查询视觉知识图谱（VGKG）以获取新闻图像
  • 自定义默认值优化后的默认设置（ArtList模式，JSON格式，50条记录，按最新排序，时间跨度1个月）
  • 布尔查询支持OR、AND运算符以及精确短语匹配
  • 灵活的时间段搜索范围为1小时至3个月的覆盖内容

安装

npm install
npm run build

配置

服务器可以通过环境变量进行配置。创建一个 .env 文件：

cp .env.example .env

可用选项：

  • GDELT_API_TIMEOUTAPI请求超时时间（毫秒）（默认：30000）
  • GDELT_API_BASE_URLGDELT API 基础 URL（默认：https://api.gdeltproject.org/api/v2/doc/doc）
  • GDELT_DEFAULT_MAX_RECORDS默认返回的最大记录数（默认值：50）
  • GDELT_DEFAULT_TIMESPAN搜索的默认时间段（默认：1个月）
  • GDELT_USER_AGENT用户代理字符串（默认：GDELT-MCP-Server/1.0）
  • LOG_LEVEL日志级别 - 调试、信息、警告、错误（默认：信息）

使用方法/用法

这个MCP服务器是设计为与MCP兼容的客户端一起使用的。请将其添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "gdelt": {
      "command": "node",
      "args": ["/path/to/gdelt-mcp-server/dist/index.js"]
    }
  }
}

可用工具

搜索文章

在GDELT的全球新闻数据库中搜索文章。

参数：

  • query （必需）：支持以下功能的搜索查询：
    • 确切短语： "climate change"
    • 逻辑或（OR）运算符： climate OR environment
    • AND 运算符： climate AND policy
  • maxRecords （可选）：结果数量（1-250，默认：50）
  • timespan （可选）：时间段，如“1月”、“7天”、“24小时”（默认：“1月”）
  • sort （可选）：排序顺序 - 按日期降序、按日期升序、按音调升序、按音调降序、混合相关性
  • startDateTime （可选）：开始日期，格式为YYYYMMDDHHMMSS
  • endDateTime （可选）：结束日期，格式为YYYYMMDDHHMMSS

示例：

{
  "query": "\"climate change\" OR \"global warming\"",
  "maxRecords": 25,
  "timespan": "7d"
}

搜索图片

在GDELT的视觉知识图谱中搜索新闻图片。

参数：

  • query （必填）：搜索词（例如，“火灾”、“抗议”、“洪水”）
  • maxRecords （可选）：图像数量（1-250，默认：50）
  • timespan （可选）：时间段（默认：“1个月”）
  • imageType （可选）：
    • imagetag按视觉内容搜索（AI在图像中看到的内容）
    • imagewebtag按标题/上下文文本搜索
    • imageocrmeta通过OCR文本和元数据进行搜索

示例：

{
  "query": "wildfire",
  "maxRecords": 30,
  "imageType": "imagetag",
  "timespan": "7d"
}

API详情

这个服务器使用GDELT DOC 2.0 API，它提供：

  • 覆盖范围为滚动的3个月窗口期（追溯至2017年1月）
  • 65种语言，使用英文搜索词
  • 基于深度学习的图像分析
  • 实时新闻数据和历史新闻数据

许可证

麻省理工学院（MIT）

相关 MCP