gdelt-mcp-server — MCP-сервер для Claude Code: установка
MCP-сервер для поиска по мировым новостям и стенограммам ТВ США через API проекта GDELT. Помогает отслеживать инфоповоды, строить графики тональности и сопоставлять цитаты.
claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcpЧто делает gdelt-mcp-server
Сервер открывает 9 инструментов для взаимодействия с базами GDELT. В распоряжении модели оказываются глобальные новости за последние 3 месяца на 65+ языках и архив стенограмм 150+ американских телеканалов с 2009 по октябрь 2024 года. Через инструмент gdelt_search_articles агент извлекает публикации по ключевым словам, доменам или темам GKG, а с помощью gdelt_get_coverage_timeline строит динамику упоминаний.
Под капотом заложен строгий лимит размера ответа в 48 000 байт. Поиск статей отдаёт максимум 250 записей за вызов; если публикаций больше, инструмент возвращает временные окна для повторных запросов. Без сужения диапазона дат обойти этот потолок не получится, так как запросы с maxRecords выше 2500 сервер сразу отклоняет.
Для работы с телевидением предусмотрены выборки стенограмм через gdelt_get_tv_clips со ссылками на Internet Archive. Сервер можно подключить по протоколу HTTP к публичному хосту https://gdelt.caseyjhand.com/mcp либо развернуть локально через npx в режиме STDIO.
Какие задачи решает
- найти публикации в мировых медиа за последние 3 месяца
- построить график частоты упоминаний инфоповода и средней тональности
- разобрать распределение тональности публикаций по гистограмме от -30 до +30
- найти фрагменты эфира американского ТВ с 2009 по октябрь 2024 года
Примеры запросов агенту
- Найди статьи про кибератаки за прошлую неделю через
gdelt_search_articles - Построй график изменения тональности новостей об изменении климата с помощью
gdelt_get_coverage_timeline - Покажи цитаты из телеэфира США про солнечную энергетику через
gdelt_get_tv_clips
Как установить gdelt-mcp-server
1Командой платформы: удалённый сервер
claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp2Командой платформы
claude mcp add --env GDELT_BASE_URL=<GDELT_BASE_URL> --env GDELT_REQUEST_DELAY_MS=<GDELT_REQUEST_DELAY_MS> --env GDELT_REQUEST_TIMEOUT_MS=<GDELT_REQUEST_TIMEOUT_MS> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> --transport stdio gdelt-mcp-server -- npx -y @cyanheads/gdelt-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add gdelt-mcp-server --url https://gdelt.caseyjhand.com/mcp2Командой платформы
codex mcp add gdelt-mcp-server --env GDELT_BASE_URL=<GDELT_BASE_URL> --env GDELT_REQUEST_DELAY_MS=<GDELT_REQUEST_DELAY_MS> --env GDELT_REQUEST_TIMEOUT_MS=<GDELT_REQUEST_TIMEOUT_MS> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> -- npx -y @cyanheads/gdelt-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"gdelt-mcp-server": {
"url": "https://gdelt.caseyjhand.com/mcp"
}
}
}{
"mcpServers": {
"gdelt-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/gdelt-mcp-server"
],
"env": {
"GDELT_BASE_URL": "<GDELT_BASE_URL>",
"GDELT_REQUEST_DELAY_MS": "<GDELT_REQUEST_DELAY_MS>",
"GDELT_REQUEST_TIMEOUT_MS": "<GDELT_REQUEST_TIMEOUT_MS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"gdelt-mcp-server": {
"type": "http",
"url": "https://gdelt.caseyjhand.com/mcp"
}
}
}{
"servers": {
"gdelt-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/gdelt-mcp-server"
],
"env": {
"GDELT_BASE_URL": "<GDELT_BASE_URL>",
"GDELT_REQUEST_DELAY_MS": "<GDELT_REQUEST_DELAY_MS>",
"GDELT_REQUEST_TIMEOUT_MS": "<GDELT_REQUEST_TIMEOUT_MS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp2Командой платформы
gemini mcp add -e GDELT_BASE_URL=<GDELT_BASE_URL> -e GDELT_REQUEST_DELAY_MS=<GDELT_REQUEST_DELAY_MS> -e GDELT_REQUEST_TIMEOUT_MS=<GDELT_REQUEST_TIMEOUT_MS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -e MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> gdelt-mcp-server npx -y @cyanheads/gdelt-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gdelt-mcp-server
Как установить gdelt-mcp-server в Claude Code?
Для подключения удалённого сервера выполните: claude mcp add --transport http gdelt-mcp-server https://gdelt.caseyjhand.com/mcp.
Зачем нужен gdelt-mcp-server?
Сервер даёт ИИ-агенту доступ к аналитике мировых новостей за 3 месяца и телеэфира США с 2009 по октябрь 2024 года. Это позволяет находить первоисточники, сравнивать цитаты и оценивать тональность публикаций.
Сколько статей сервер возвращает за один запрос?
Инструмент gdelt_search_articles возвращает максимум 250 публикаций, которые укладываются в лимит 48 000 байт. Для получения остальных данных инструмент отдаёт временные интервалы для повторного запроса.
