🇸🇬 Singapore MCP

Серверы Model Context Protocol с открытым исходным кодом для публичных данных и сервисов Сингапура.

Создано и поддерживается в Сингапуре компанией Olano.

Это независимый общественный проект. Он не аффилирован с правительством Сингапура или каким-либо государственным ведомством, не одобрен ими и не является их официальным продуктом.

Пакеты

Все пакеты поддерживают локальные транспорты stdio и Streamable HTTP.

Related MCP server: Gahmen MCP Server

Быстрый старт

Запустите полный набор Singapore через stdio:

npx @olano/mcp-singapore

Или запустите специализированный сервер:

npx @olano/mcp-onemap
npx @olano/mcp-weather

Запустите агрегированный сервер через Streamable HTTP:

npx @olano/mcp-singapore --transport http --host 127.0.0.1 --port 3000

Конечная точка MCP — http://127.0.0.1:3000/mcp. Адрес привязки по умолчанию — localhost. Размещайте аутентификацию и TLS перед любым развёртыванием, доступным из интернета.

Конфигурация клиента

Добавьте агрегированный сервер в клиент, который принимает распространённый JSON-формат mcpServers:

{
  "mcpServers": {
    "singapore": {
      "command": "npx",
      "args": ["-y", "@olano/mcp-singapore"],
      "env": {
        "DATA_GOV_SG_API_KEY": "optional-data-gov-key",
        "ONEMAP_TOKEN": "your-onemap-token",
        "LTA_DATAMALL_API_KEY": "optional-lta-account-key"
      }
    }
  }
}

Удалите неиспользуемые переменные окружения. Никогда не коммитьте реальные учётные данные.

Инструменты

Имена инструментов используют пространства имён и стабильны:

• datagov_list_datasets, datagov_get_dataset_metadata, datagov_list_dataset_rows

• datagov_get_realtime

• onemap_search, onemap_reverse_geocode, onemap_route

• lta_bus_arrivals, lta_list_bus_stops, lta_traffic_incidents

• lta_traffic_images, lta_carpark_availability, lta_taxi_availability

• weather_two_hour_forecast, weather_twenty_four_hour_forecast

• weather_four_day_outlook, weather_temperature, weather_rainfall, weather_air_quality

• singapore_location_brief

Серверы доступны только для чтения. Входные данные проверяются с помощью Zod, адреса вышестоящих сервисов и пути API фиксированы в коде, запросы имеют тайм-ауты и ограничения размера ответа, запросы с временными сбоями повторяются, а ответы GET кратковременно кэшируются. Вызовы вышестоящих сервисов изначально ограничиваются по скорости для каждого клиента провайдера, чтобы избежать всплесков нагрузки на публичные сервисы.

Учётные данные

Динамические API LTA требуют регистрации. API OneMap требуют учётной записи OneMap и токена. Публичные конечные точки data.gov.sg в реальном времени можно тестировать без ключа, но пользователям в продакшене следует его получить.

Источники данных и атрибуция

• Руководство по API data.gov.sg

• Документация OneMap API

• LTA DataMall

• Meteorological Service Singapore

• Singapore Open Data Licence

Доступность API, точность данных, ограничения скорости и условия вышестоящих сервисов контролируются соответствующими провайдерами. Приложения, использующие возвращаемые данные, должны соблюдать соответствующие условия источников и требования к атрибуции.

Разработка

npm install
npm run format:check
npm run lint
npm test
npm run build

Используйте официальный MCP Inspector для интерактивного тестирования:

npx @modelcontextprotocol/inspector node packages/singapore/dist/cli.js

См. Архитектура, Участие в разработке и Безопасность.

Дорожная карта

• Специализированные пакеты HDB и URA на основе документированных публичных наборов данных

• Поиск публичных данных о компаниях ACRA с учётом условий наборов данных и практической пагинации

• Дополнительные межведомственные инструменты для районов, мобильности и местоположений бизнеса

• Размещённые аутентифицированные конечные точки и публикация в MCP Registry

• Интероперабельность SingStat вместо дублирования официального MCP Singapore Department of Statistics

Лицензия

Исходный код распространяется под лицензией MIT. Государственные данные остаются под действием лицензии и условий, опубликованных каждым ведомством-источником.