GDELT MCP服务器
模型上下文协议(MCP)服务器,用于与GDELT(事件、语言和音调的全局数据库)API集成。通过6个核心工具提供对全球新闻报道、情绪分析、地理数据和视觉内容的访问。
特性
- 不要求进行验证 -GDELT API完全开放
- 实时数据 -每15分钟更新一次
- 6核心工具:
- 使用高级过滤器搜索文章 - 时间线分析(音量、音调、语言、来源国) - 情绪/语调分布 - 使用GeoJSON输出进行地理搜索 - 视觉内容搜索 - 实时新闻监控
安装
npm install建筑
npm run build跑步
发展模式
npm run dev生产模式
npm startClaude桌面配置
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json
选项1:使用npx(推荐-无需安装)
{
"mcpServers": {
"gdelt": {
"command": "npx",
"args": ["-y", "@anysiteio/gdelt-mcp-server"]
}
}
}方案2:地方发展
{
"mcpServers": {
"gdelt": {
"command": "node",
"args": ["/absolute/path/to/GDELT-mcp/dist/index.js"]
}
}
}更新配置后,重新启动Claude Desktop。
可用工具
1.gdelt_search_文章
使用高级过滤功能搜索新闻文章。
参数:
query(必填):带运算符的搜索查询timespan(可选,默认:“3d”):时间窗口(15分钟、2小时、3d、1w、2m)maxrecords(可选,默认值:75):最大结果(1-250)sort(可选,默认:“DateDesc”):排序顺序
查询运算符:
"phrase"-精确短语匹配domain:cnn.com-按域筛选sourcecountry:russia-按来源国筛选sourcelang:spanish-按语言筛选tone3-面孔数量
例子:
query: imagetag:"protest" imagenumfaces>5
timespan: 1w6.gdelt_monitor
监控实时新闻报道。
参数:
query(必填):搜索查询interval(可选,默认:“15min”):监测间隔
- 15min:最后15分钟 - 1h:最后一小时 - 3h:过去3小时
例子:
query: "breaking news" domain:cnn.com
interval: 15minGDELT API限值
- API文件:过去3个月,每次请求最多250个结果
- GEO API:最近7天,最高1000点
- 更新频率:每15分钟
- 速率限制:无(负责任地使用)
项目结构
GDELT-mcp/
├── src/
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server setup
│ ├── tools/ # Tool implementations
│ │ ├── search-articles.ts
│ │ ├── timeline.ts
│ │ ├── tone-chart.ts
│ │ ├── geo-search.ts
│ │ ├── image-search.ts
│ │ └── monitor.ts
│ ├── gdelt/ # GDELT API client
│ │ ├── client.ts
│ │ ├── types.ts
│ │ └── utils.ts
│ └── schemas/ # Zod validation schemas
│ └── tool-schemas.ts
├── package.json
├── tsconfig.json
└── README.md资源
许可证
麻省理工学院
