DaedalMap Volcanic Activity

DaedalMap

データを持ち込み、地理情報をつなげましょう。

DaedalMap は、地理情報の相互運用を支えるインフラです。loc_id 識別モデル、バージョン管理された境界ジオメトリ、地理システム間で公開されたクロスウォーク、そして維持管理されたデータパックを提供します。座標や参照コードを行政区画に対応付け、互換性のある形状やデータを取得し、国勢調査区、郵便区、水域、選挙区などの別のシステムへクロスウォークをたどって移動できます。

リモート MCP サーバー、HTTP API、マップアプリ、ダウンロード可能なファイル、またはそのすべてを支えるオープンランタイムであるこのリポジトリから利用できます。

ウェブサイト | アプリ | エージェント向けドキュメント | ジオメトリ | データパック | ダウンロード | ファイルを変換 | llms.txt

エージェントを接続する

ホスト型 MCP サーバーは、検出にインストールもアカウントも必要ありません。

https://app.daedalmap.com/mcp?registry=github

Claude Code：

claude mcp add --transport http daedalmap 'https://app.daedalmap.com/mcp?registry=github'

Codex：

codex mcp add daedalmap --url 'https://app.daedalmap.com/mcp?registry=github'

ストリーミング可能な HTTP MCP に対応するクライアントであれば、同じ URL を利用できます。地理情報関連の作業には topic='geometry' を指定した get_tool_help から始めるか、データの場合は get_catalog、次に get_pack、続いて get_data の順に使用してください。他のクライアントのセットアップ方法はエージェント向けドキュメントをご覧ください。

検出と小規模な地理情報の検索は無料です。大量の地点／参照コードの一括処理と一部のデータパックは従量制です。有料の呼び出しでは、料金が発生する前に正確な価格が表示され、API キーを使用してアカウントのクレジットから支払われます。get_pack では、選択したデータパックのアクセス方法が示されます。

ツール

作業	ツール
モデルを理解する	トピックまたは正確なツール名を指定した get_tool_help
利用可能なものを探す	get_catalog。続いて、データパックには get_pack、ジオメトリのファミリーまたは範囲には get_geography
維持管理されたデータを照会する	pack_id、正確な指標、構造化フィルターを指定した get_data
1 件の災害イベントを調べる	get_data が返す正確な event_id を指定した get_event
座標から場所を特定する	resolve_point。Admin 4-6 またはさらに深いファミリーが必要な場合は、続けて resolve_deep_point
コード列を識別する	identify_dataset_geography、identify_reference_system
システム間でコードを変換する	convert_reference
場所を調べ、関連付ける	get_loc_id_info、compare_geographies
形状を取得する	正確な loc_id を指定した get_shape

各ツールは厳密な JSON 引数を受け取ります。呼び出し元のモデルがユーザーの質問をこれらの引数に変換し、呼び出しの形式が正しくない場合、サーバーは修正方法を示す型付きエラーを返します。

この表は公開されているツールの全一覧であり、今後の予定ではありません。一括エクスポート／ジョブ構築ツールや、上流のライブフィードを直接利用するラッパーは内部用、または一時停止中のため、tools/list には意図的に含めていません。

loc_id モデル

loc_id は DaedalMap の地理的な識別モデルです。行政区画の幹となる階層が主要な階層であり、デフォルトの結合経路です。

USA                      country
USA-CA                   state
USA-CA-037               county
USA-CA-037-221710        census tract

郵便区、水域、部族地域、海洋地域など、その他の地理ファミリーは、それぞれ独自の loc_id 識別情報を保持します。公開されたクロスウォークによって、それらを幹となる階層や相互に接続します。また、クロスウォークの各行には、関係の種類、重複の重み、出典、基準時点が記録されています。両方のデータセットが同じ識別情報を宣言している場合は直接結合できます。それ以外の場合は、クロスウォークを経由して接続します。

スキーマの詳細はdocs/DATA_SCHEMAS.mdをご覧ください。

対応範囲

ジオメトリ：世界全体の基本データと、8か国以上の詳細データ。 同じ地理ツールを世界中で Admin 2 まで利用できます。各国のリリースでは、オーストラリア、ブラジル、カナダ、フランス、ドイツ、メキシコ、英国、米国などについて、より詳細な行政階層と参照データファミリーが追加されます。これらはリリースの公開に合わせて順次追加されます。

データ：20種類以上の保守対象データパックがあり、自然災害（地震、津波、火山、ハリケーン、竜巻、山火事、洪水、気象警報）、災害リスクと環境負荷、経済・ビジネス指標、為替レート、人口、気候を網羅しています。

現在利用できるデータについては、カタログが正式な情報源です。

• ジオメトリ：app.daedalmap.com/api/v1/geometry/catalog
• データパック：app.daedalmap.com/api/v1/catalog

ダウンロード

Windows ランチャーの公開ソース、ビルドスクリプト、テストは tools/launcher にあります。ポータブル版をダウンロードすると、既定ではプログラムと管理対象のランタイムがランチャーフォルダー内に保持されます。

ダウンロードページには、次の3種類のファイルがあります。

• プログラム - DaedalMap をマシン上で実行するためのマップアプリまたはローカル MCP ランタイムです。
• データパック - ソースとリリースの根拠情報を含む、特定の主題に関する保守対象の記録です。
• ジオメトリパッケージ - 国またはファミリーの境界と参照地理データです。

自分で実行する

このリポジトリはオープンなランタイムです。FastAPI サーバー、MCP と HTTP API、マップフロントエンドが含まれています。セルフホストしたり、独自のデータで実行したり、エンジンを拡張したりするために使用できます。

Network expansion もこのリポジトリに含まれています。ローカルの Mapping マップに、オプションの鉄道、河川、電力レイヤーを追加できます。また、Mapping がなくても実行できる、独立したスプレッドシートエディターと Parquet CLI も提供します。以前の Lake County 道路マップエディターは、参考用コードとしてアーカイブされています。

すべてのソースディレクトリをチェックアウトせずに、ローカルプログラムを1つだけ開発する方法については、ローカルツールを1つ開発するを参照してください。ツールのソース一覧には、Mapping、Network、Research MCP、Geometry MCP、オプションの AI 拡張機能と、それぞれの現在の移行状況が記載されています。

cd county-map
pip install -r requirements.txt
Copy-Item .env.example .env

.env でデータフォルダーを設定します。

INSTALL_MODE=local
RUNTIME_MODE=local
DATA_ROOT=C:/path/to/your/data

既定のアプリデータフォルダーを使用する場合は、DATA_ROOT を空欄のままにします。クラウドストレージ、データベース、アカウントは不要です。このリポジトリにはデータフォルダーは含まれていません。データパックのインストール方法については、docs/DATA_INSTALLATION.mdを参照してください。

python app.py

アプリは http://localhost:7000 で開きます。同じ MCP サーバーは http://localhost:7000/mcp で利用できます。ディスカバリールートは次のとおりです。

• GET /api/v1/guide
• GET /api/v1/catalog
• GET /api/v1/packs/{pack_id}
• POST /api/v1/query/dataset

モデル API キーは任意です。OPENAI_API_KEY または ANTHROPIC_API_KEY は組み込みのチャットパネルのみで使用されます。MCP クライアントでは独自のモデルを使用します。セルフホストしたインスタンスでは、商用検証機能を設定しない限り、有料レーンで commercial_access_unavailable が返されます。

ランタイムモード

INSTALL_MODE	RUNTIME_MODE	用途
local	local	自分のマシンと、自分のデータフォルダー
local	cloud	自分のマシンで、設定したオブジェクトストレージから Parquet を読み込みます
cloud	cloud	オブジェクトストレージから読み込むサーバーデプロイメント

cloud データモードでは、ランタイムは小さなメタデータファイルをローカルにキャッシュし、DuckDB httpfs を通じてオブジェクトストレージ内の Parquet をクエリします。詳細については、docs/LOCAL_AND_HOSTED.mdを参照してください。

ドキュメント

• docs/CONTEXT.md - コードベースの技術的な案内
• docs/API_AND_MCP.md - HTTP ルートと MCP のインターフェース
• docs/DATA_SCHEMAS.md - スキーマと loc_id の規約
• docs/DATA_PREPARATION.md - 独自データの変換と検証
• docs/DATA_INSTALLATION.md - データのローカルインストール
• docs/PACK_AUTHORING.md - リサーチパックとコーパスの作成
• docs/RESEARCH_MCP.md - ホスト型 MCP を使ったリサーチ
• docs/RUNTIME_MODES.md - Explore、Research、Ops、Tutorial
• docs/SECURITY_AND_SELF_HOSTING.md - 安全なセルフホスティング

お問い合わせ

ご質問、ご意見、セルフホスティングに関する問題は、[email protected] までご連絡ください。

ライセンス

MIT。データパックとジオメトリにはそれぞれ個別のソースライセンスがあり、各カタログエントリーに記載されています。

このリポジトリを読むエージェント向け

DaedalMap の評価を依頼された場合は、まず公開コンテキストマップを確認し、次にホスト型ツールについてはAPI と MCP の仕様、ローカルのアーティファクトについてはデータのインストールを参照してください。ソースのチェックアウトには、データパックやジオメトリパッケージは含まれていません。現在の対応範囲を説明する前に、最新のデータカタログとジオメトリカタログを確認してください。回答では、リポジトリのコード、ダウンロード可能なアーティファクト、ホスト型サービスの動作を区別してください。