ckan-mcp-server — MCP-сервер для Claude Code: доступ к порталам
Подключает ИИ-ассистента к порталам открытых данных на CKAN: поиск наборов данных, организаций, метаданных и табличных запросов на естественном языке.
claude mcp add --env CKAN_ALLOWED_DOMAINS=<CKAN_ALLOWED_DOMAINS> --transport stdio ckan-mcp-server -- npx -y @aborruso/ckan-mcp-serverЧто делает ckan-mcp-server
CKAN — платформа, на которой работает большинство государственных порталов открытых данных. Обычно чтобы что-то найти, надо знать структуру портала, API и синтаксис поиска. Сервер убирает этот барьер: после подключения ассистент сам делает поиск и разбор данных.
Внутри — набор инструментов для поиска наборов данных (ckan_package_search), запросов к табличным данным (ckan_datastore_search), списка тегов, поиска порталов и подбора релевантных наборов. Метаданные идут по стандарту DCAT. Установить можно двумя способами: локально через npm install -g @aborruso/ckan-mcp-server или без установки, подключившись к размещённому endpoint https://ckan-mcp-server.andy-pr.workers.dev/mcp. У размещённого варианта общая квота 100k запросов в день, у локального квоты нет.
Есть ограничения по объёму вывода: 50 000 символов на ответ, строки в ckan_datastore_search по умолчанию 100, максимум 32 000. Усечённые JSON-ответы помечаются _truncated и _original_count, так что клиент видит те же данные, что и в тексте. Если нужен полный результат — используйте пагинацию или более узкий запрос. Для локального запуска в Node.js можно задать лимиты через CKAN_MAX_RESPONSE_BYTES и CKAN_MAX_DECOMPRESSED_BYTES. Переменная CKAN_ALLOWED_DOMAINS задаёт, к каким порталам разрешено обращаться.
Какие задачи решает
- найти набор данных на портале CKAN, не зная его структуры и API
- выполнить табличный запрос к данным через datastore
- собрать список организаций и тегов портала
- проверить, какие данные публикует конкретное ведомство
- подобрать релевантные наборы данных под тему исследования
Примеры запросов агенту
- Найди на портале данные о качестве воздуха за прошлый год
- Покажи организации, которые публикуют наборы данных на этом портале
- Сделай запрос к таблице
ckan_datastore_searchи выведи первые строки
Как установить ckan-mcp-server
Командой платформы
claude mcp add --env CKAN_ALLOWED_DOMAINS=<CKAN_ALLOWED_DOMAINS> --transport stdio ckan-mcp-server -- npx -y @aborruso/ckan-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add ckan-mcp-server --env CKAN_ALLOWED_DOMAINS=<CKAN_ALLOWED_DOMAINS> -- npx -y @aborruso/ckan-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ckan-mcp-server": {
"command": "npx",
"args": [
"-y",
"@aborruso/ckan-mcp-server"
],
"env": {
"CKAN_ALLOWED_DOMAINS": "<CKAN_ALLOWED_DOMAINS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ckan-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aborruso/ckan-mcp-server"
],
"env": {
"CKAN_ALLOWED_DOMAINS": "<CKAN_ALLOWED_DOMAINS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CKAN_ALLOWED_DOMAINS=<CKAN_ALLOWED_DOMAINS> ckan-mcp-server npx -y @aborruso/ckan-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ckan-mcp-server
Как установить ckan-mcp-server в Claude Code?
Выполните claude mcp add ckan-mcp-server -- npx -y @aborruso/ckan-mcp-server. Если нужно ограничить домены, используйте вариант с переменной: claude mcp add --env CKAN_ALLOWED_DOMAINS=<CKAN_ALLOWED_DOMAINS> --transport stdio ckan-mcp-server -- npx -y @aborruso/ckan-mcp-server.
Что делает ckan-mcp-server?
Даёт ассистенту доступ к порталам открытых данных на CKAN: поиск наборов данных, организаций, тегов и метаданных, а также запросы к табличным данным через datastore.
Чем отличается локальная установка от размещённого endpoint?
Локальный вариант работает на вашей машине и не имеет общей квоты. Размещённый endpoint https://ckan-mcp-server.andy-pr.workers.dev/mcp подходит для быстрого старта, но у него общая квота 100k запросов в день.