hithereiamaliff-mcp-datagovmy

Malaysia Open Data MCP

MCP エンドポイント： https://mcp.techmavie.digital/datagovmy/mcp

分析ダッシュボード： https://mcp.techmavie.digital/datagovmy/analytics/dashboard

マレーシアのオープンデータ API 向け MCP（Model Context Protocol）サーバーです。データセット、ダッシュボード、DOSM、天気、洪水、parquet ファイル、GTFS 交通データ用のツールを提供します。

これは、マレーシア政府、Jabatan Digital Negara、またはデジタル省の公式 MCP サーバーではありません。

特長

• データセットとダッシュボードを横断する統合検索
• data-gov-my/datagovmy-meta からメタデータをリアルタイムで取得
• raw、summary、latest-period モードに対応した、JavaScript のみでの parquet 解析
• GTFS 静的データとリアルタイム交通データ用ツール
• GTFS の位置検索に対応する、認証情報不要のジオコーディング
• 分析用エンドポイントとダッシュボードを内蔵

ジオコーディング

GTFS の位置検索では、Nominatim（OpenStreetMap）のみを使用するようになりました。

• Google Maps、GrabMaps、AWS の認証情報は不要です
• ホスト型 MCP の URL は、認証情報なしですぐに使用できます
• 公開 Nominatim サービスへの配慮として、リクエストを制限し、キャッシュします
• セルフホストする場合は、任意で NOMINATIM_CONTACT_EMAIL を設定できます

クイックスタート

ホスト型サーバー

ホストされたエンドポイントを直接使用します。

https://mcp.techmavie.digital/datagovmy/mcp

MCP クライアント設定の例：

{
  "mcpServers": {
    "malaysia-opendata": {
      "transport": "streamable-http",
      "url": "https://mcp.techmavie.digital/datagovmy/mcp"
    }
  }
}

API キーやジオコーディングの認証情報は不要です。

セルフホスト

VPS へのデプロイ手順の詳細は、deploy/DEPLOYMENT.md をご覧ください。

npm install
npm run build
npm run start:http

ツールの概要

検索とメタデータ

• search_all
• list_datasets_catalogue
• search_datasets_catalogue
• filter_datasets_catalogue
• get_dataset_filters
• get_dataset_details
• list_dashboards
• search_dashboards
• get_dashboard_details
• get_dashboard_charts
• list_dosm_datasets
• get_dosm_dataset

ファイルとダッシュボード

• parse_parquet_file
• get_parquet_info
• find_dashboard_for_parquet

天気と洪水

• get_weather_forecast
• get_weather_warnings
• get_earthquake_warnings
• get_flood_warnings

交通と GTFS

• list_transport_agencies
• get_transport_data
• get_gtfs_static
• get_gtfs_realtime_vehicle_position
• parse_gtfs_static
• parse_gtfs_realtime
• get_transit_routes
• get_transit_stops
• get_transit_arrivals
• search_transit_stops_by_location
• find_nearest_transit_stops

その他

• hello

詳しい情報と使用方法については、TOOLS.md と PROMPT.md をご覧ください。

ローカル開発

# Install dependencies
npm install

# Run the HTTP server in development mode
npm run dev:http

# Build and run the production server locally
npm run build
npm run start:http

# Verify the server
curl http://localhost:8080/health
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

分析

ホスト型サーバーでは、次のエンドポイントを利用できます。

• /analytics：JSON 形式の統計情報
• /analytics/tools：ツールの使用状況統計
• /analytics/dashboard：HTML ダッシュボード

設定

基本環境変数

変数	デフォルト値	説明
PORT	8080	HTTP サーバーのポート
HOST	0.0.0.0	バインドアドレス
API_BASE_URL	https://api.data.gov.my	Malaysia Open Data API のベース URL
CACHE_TTL	3600000	メタデータキャッシュの TTL（ミリ秒）
AXIOS_TIMEOUT	30000	HTTP タイムアウト（ミリ秒）
GITHUB_FETCH_BATCH_SIZE	20	同時に取得する GitHub メタデータの件数
GH_PAT	empty	GitHub API のレート制限引き上げに使用する任意の GitHub トークン
ANALYTICS_RESET_KEY	empty	分析のリセット／インポートエンドポイント用の秘密鍵
ANALYTICS_DIR	/app/data	分析データの保存ディレクトリ
FIREBASE_DATABASE_URL	empty	分析データの永続化に使用する Firebase Realtime Database の URL
FIREBASE_CREDENTIALS_PATH	.credentials/firebase-service-account.json	Firebase サービスアカウントのパス
NOMINATIM_CONTACT_EMAIL	empty	セルフホスト環境で Nominatim のクエリに追加する任意の連絡先メールアドレス

.env の例：

GH_PAT=your_github_pat_here
[email protected]
ANALYTICS_RESET_KEY=your_analytics_reset_key_here
ANALYTICS_DIR=/app/data
FIREBASE_DATABASE_URL=your_firebase_database_url_here
FIREBASE_CREDENTIALS_PATH=.credentials/firebase-service-account.json

Nominatim に関する注意事項

このサーバーは現在、GTFS の位置名検索にパブリックな Nominatim を使用しています。コードには以下が含まれています。

• カスタム User-Agent
• NOMINATIM_CONTACT_EMAIL による任意の email のサポート
• 1 秒あたり 1 リクエストを下限とする、リクエストの直列化
• 成功結果と失敗結果のキャッシュ

ジオコーディングのトラフィックが継続的に発生すると見込まれる場合は、互換性のあるジオコーダーのセルフホスト、または承認済みの独自サービスを経由したルーティングをご検討ください。

プロジェクト構成

src/
  index.ts
  http-server.ts
  config.ts
  datacatalogue.tools.ts
  dashboards.tools.ts
  dosm.tools.ts
  flood.tools.ts
  gtfs.tools.ts
  parquet.tools.ts
  transport.tools.ts
  unified-search.tools.ts
  weather.tools.ts
  firebase-analytics.ts
  utils/

deploy/
  DEPLOYMENT.md
  nginx-mcp.conf

トラブルシューティング

# Docker logs
docker compose logs -f

# Local health check
curl http://localhost:8080/health

# Hosted MCP tool list
curl -X POST https://mcp.techmavie.digital/datagovmy/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ライセンス

MIT。詳細は LICENSE をご覧ください。

謝辞

• Malaysia Open Data Portal
• Department of Statistics Malaysia
• Malaysian Meteorological Department
• Nominatim
• Model Context Protocol