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）