Dit is deArcGIS Adventskalender 2025 artikel voor dag 24. Bekijk ook zeker de andere artikelen.
Inleiding
Ook dit jaar waren AI en ontwikkeling onophoudelijk onderwerp van gesprek in het jaar 1.
Binnen ArcGIS wordt niet alleen GeoAI ontwikkeld, maar ook AI-functies zoals de AI assistenten die in verschillende producten beschikbaar zijn en de binnenkort te verschijnen AI agenten, waarmee eengeoruimtelijk AI-platformwordt opgebouwd.
Van alle onderwerpen rond AI en ontwikkeling is Model Context Protocol (MCP) waarschijnlijk een van de meest opvallende technologieën.
In dit artikel willen we met FastMCP, dat het eenvoudig maakt om een MCP-server te bouwen, een ArcGIS-routezoekfunctie integreren in een AI-chatapplicatie die gebruikmaakt van grote taalmodellen (LLM), zoals hieronder weergegeven.LLM)
Voorbeeldconfiguratie van een MCP-server die een AI-chatapp verbindt met een routezoekfunctie
Wat is Model Context Protocol (MCP)?
MCP is een open protocol waarmee LLM's veilig en uniform kunnen samenwerken met externe tools (zoals web-API's). Deze technologie is ontwikkeld en gepromoot door Anthropic, een bekend AI-bedrijf achter Claude, en wordt breed ondersteund door ontwikkelaars van AI-applicaties. Het is zonder twijfel een van de meest besproken LLM-gerelateerde technologieën van dit jaar, mede doordat diverse AI-chatapps MCP ondersteunen.
Ook op het gebied van georuimtelijke informatie wordt binnen Japan het MCP-serverconcept toegepast op het nationale georuimtelijke dataportaalNational Spatial Data PlatformMCP-serverszijn daar beschikbaar.
Belangrijkste software en bibliotheken gebruikt in dit artikel
Hieronder volgt een lijst met software die kan verbinden met MCP en handige bibliotheken om MCP-servers te bouwen.
Een framework om snel en eenvoudig MCP-servers/clients in Python te bouwen. In dit artikel gebruiken we het om een MCP server te maken.
De desktopapplicatie van de AI-chatapp Claude, aangeboden door Anthropic. In dit artikel gebruiken we deze als MCP-host om verbinding te maken met de MCP-server en de correcte werking te verifiëren.MCP
Een gratis broncode-editor van Microsoft. In dit artikel gebruiken we de GitHub Copilot Chat-extensie als MCP-host, net als Claude Desktop.
return json.loads(resp.read())
if __name__=="__main__":
stops=[(139.745486, 35.658569),(139.749603, 35.660191)]
result = _call_arcgis_route(stops, API_KEY, return_directions=True,depart="now")
if "error" in result:
raise RuntimeError(result["error"])
print(result)
上記のスクリプトで、2点間のルート検索を行うことができます。
スタート地点を東京タワー、ゴール地点を芝公園の緯度経度を入力しているので実行してみるとルートの詳細を JSON 形式で返してくれています。
Python スクリプトを実行した結果
なお、今回はチャットの文章でルート検索ができるようにしたいので、
上記のスクリプトに住所検索とルート検索で移動手段を指定する際に利用する移動手段のエンド ポイントにリクエストする関数を追加しています。
追加した例が下記のスクリプトです。
import json
import urllib.parse
import urllib.request
GEOCODE_FIND_URL = "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/findAddressCandidates"
ARCGIS_ROUTING_URL = "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
ARCGIS_TRAVELMODE_URL = "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/retrieveTravelModes"
API_KEY ="<事前に用意した API キー>"
def _http_get(url: str) -> dict:
with urllib.request.urlopen(url, timeout=30) as resp:
return json.loads(resp.read())
def geocode_address(address: str, token: str, country_code: str = "JP") -> dict:
"""
住所や都市名、POI から 緯度経度へ変換する。
"""
params = {
"f": "json",
"token": token,
"SingleLine": address,
"countryCode": country_code,
"outFields": "*",
"langCode": "ja",
"maxLocations": 1
}
url = GEOCODE_FIND_URL + "?" + urllib.parse.urlencode(params)
result = _http_get(url)
if "error" in result:
raise RuntimeError(result["error"])
for c in result.get("candidates", []):
loc = c.get("location") or {}
return {
"lon": loc.get("x"),
"lat": loc.get("y"),
}
def _travel_mode_selector(travelMode: str, token: str):
"""
travelMode 引数から ArcGIS Routing の travelMode 名を返す。
"""
params = {
"f": "json",
"token": token
}
url = ARCGIS_TRAVELMODE_URL + "?" + urllib.parse.urlencode(params)
travelmode_list=_http_get(url)["supportedTravelModes"]
# 一致した文字列があれば travelmode として返す。
for travelmode in travelmode_list:
if travelmode["name"]== travelMode:
travelmode_param=travelmode
break
return travelmode_param
def _call_arcgis_route(stops, token, return_directions=True, travel_mode="運転時間", depart="now"):
params = {
"f": "json",
"token": token,
"stops": ";".join(f"{x},{y}" for (x, y) in stops),
"returnDirections": str(return_directions).lower(),
"travelMode": travel_mode, # 追加
"startTime": depart, # now / yyyy-mm-ddThh:mm:ss
}
url = ARCGIS_ROUTING_URL + "?" + urllib.parse.urlencode(params)
return _http_get(url)
if __name__=="__main__":
stops=["東京タワー","芝公園"]
result = _call_arcgis_route(stops, API_KEY, return_directions=True,depart="now")
if "error" in result:
raise RuntimeError(result["error"])
print(result)
FastMCP で MCP サーバー化
FastMCP は MCP サーバー/クライアントを Python で簡単・高速に構築できるフレームワークです。
ここからは上記で作成した Python スクリプトを FastMCP を使って MCP サーバー化していきましょう。
FastMCP のインストール
FastMCP は pip からライブラリをインストールできます。
pip install fastmcp
上記のコマンドを実行したあとで FastMCP がインストールされているか下記のスクリプトを実行して試してみましょう。
インストールした時点での最新版がインストールされているはずです。
import fastmcp
print(fastmcp.__version__)
# >> 2.xyz.x
ArcGIS Routing MCP サーバーを作成する
ここまで作成してきたルート検索用のエンド ポイントにリクエストを送信する Python スクリプトに FastMCP ライブラリをインポートし、MCP サーバーを立ち上げるためのスクリプトを記述していきます。
追加したスクリプトが下記となります。追加したコマンドや関数には、コメント アウトで追加した旨を記載してあります。
import json
import urllib.parse
import urllib.request
from fastmcp import FastMCP # 追加
mcp = FastMCP("ArcGIS Routing MCP Server") # 追加
GEOCODE_FIND_URL = "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/findAddressCandidates"
ARCGIS_ROUTING_URL = "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve"
ARCGIS_TRAVELMODE_URL = "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/retrieveTravelModes"
API_KEY ="<vooraf voorbereide API-sleutel>"
def _http_get(url: str) -> dict:
with urllib.request.urlopen(url, timeout=30) as resp:
return json.loads(resp.read())
def geocode_address(address: str, token: str, country_code: str = "JP") -> dict:
"""
Zet een adres, stadsnaam of POI om naar breedte- en lengtegraad.
"""
params = {
"f": "json",
"token": token,
"SingleLine": address,
"countryCode": country_code,
"outFields": "*",
"langCode": "ja",
"maxLocations": 1
}
url = GEOCODE_FIND_URL + "?" + urllib.parse.urlencode(params)
result = _http_get(url)
if "error" in result:
raise RuntimeError(result["error"])
for c in result.get("candidates", []):
loc = c.get("location") or {}
return {
"lon": loc.get("x"),
"lat": loc.get("y"),
}
def _travel_mode_selector(travelMode: str, token: str):
"""
Geeft de ArcGIS Routing travelMode naam terug op basis van het travelMode argument.
"""
params = {
"f": "json",
"token": token
}
url = ARCGIS_TRAVELMODE_URL + "?" + urllib.parse.urlencode(params)
travelmode_list=_http_get(url)["supportedTravelModes"]
# Als er een overeenkomende string is, retourneer die als travelmode.
for travelmode in travelmode_list:
if travelmode["name"]== travelMode:
travelmode_param=travelmode
break
return travelmode_param
def _call_arcgis_route(stops, token, return_directions=True, travel_mode="運転時間", depart="now"):
params = {
"f": "json",
"token": token,
"stops": ";".join(f"{x},{y}" for (x, y) in stops),
"returnDirections": str(return_directions).lower(),
"travelMode": travel_mode, # toegevoegd
"startTime": depart, # now / yyyy-mm-ddThh:mm:ss
}
url = ARCGIS_ROUTING_URL + "?" + urllib.parse.urlencode(params)
return _http_get(url)
# Vanaf hier toegevoegd
@mcp.tool()
def solve_route(
stop_list: list,
depart: str = "now",
travelMode: str = "運転時間",
) -> dict:
"""
Roept ArcGIS Routing's Route_World aan en retourneert de kortste/snelste route en instructies.
Args:
stop_list: lijst met tussenstops (lijst van adresstrings)
depart: vertrektijd ("now" of ISO8601), standaard is "now" als niet gespecificeerd.
travelMode: vervoersmiddel ("運転時間", "運転距離","徒歩時間","徒歩距離","トラック輸送時間","トラック輸送距離", "運転時間 (未舗装道路使用)","運転距離 (未舗装道路使用)"), standaard is "運転時間" als niet gespecificeerd.
Returns:
Woordenboek met routevorm, tijd, afstand en instructies (indien mogelijk in het Japans).
"""
stops=[]
for stop in stop_list:
geocode_result=geocode_address(stop, API_KEY)
stops.append((geocode_result["lon"], geocode_result["lat"]))
result = _call_arcgis_route(stops, API_KEY, return_directions=True, travel_mode=_travel_mode_selector(travelMode, API_KEY), depart=depart)
if "error" in result:
raise RuntimeError(result["error"])
return result # MCP tool retourneert JSON/object is prima.
# Tot hier toegevoegd.
if __name__ == "__main__":
mcp.run() # hier toegevoegd.
# Hieronder uitcommentariëren.
# stops=["東京タワー","芝公園"]
# result = _call_arcgis_route(stops, API_KEY, return_directions=True,depart="now")
# if "error" in result:
# raise RuntimeError(result["error"])
# print(result)
'Het punt hier is' '@mcp' 'tool' 'Dat de onderstaande functie wordt beschreven als een tool die LLM gebruikt voor scripts en tools. Wanneer LLM MCP-server raadpleegt, controleert het deze beschrijving en maakt het de benodigde argumenten JSON voor verzoeken. Daarom worden de datatypes en beschrijvingen van vereiste argumenten in commentaar gezet om verkeerd gebruik door LLM te voorkomen.'
'Als dit script zonder problemen draait, zal de MCP-server lokaal opstarten zoals hieronder afgebeeld.'
'MCP-server starten'
'Het script dat tot nu toe is geschreven kan worden ingesteld in Claude Desktop,'
'maar om te testen of het echt werkt maken we ook een MCP-client met de FastMCP-bibliotheek.'
'MCP-server aanroepen via client'
'Aan clientzijde schrijven we een script om de tool die op MCP-server staat aan te roepen,'
'zoals hieronder.'
'import asyncio'
'from fastmcp import Client'
from fastmcp.client.transports import PythonStdioTransport
async def main():
# サーバーを起動
transport = PythonStdioTransport(script_path="./arcgis_route.py")
# MCP クライアントを作成し、MCP サーバーに接続
async with Client(transport) as client:
# solve_route ツールの呼び出し
result = await client.call_tool("solve_route",
{
"stop_list": ["東京駅","東京タワー"],
"travelMode": "運転時間"
}
)
print("ツール呼び出し結果:", result)
if __name__ == "__main__":
asyncio.run(main())
ここでは、クライアントから MCP サーバーを起動しているため、スクリプトを実行するとルート検索の結果が表示されるようになっています。
実際に実行してみた結果は下図の通りです。
MCPクライアントを実行
ArcGIS Routing MCP サーバーが正しく動作していていることがわかったので、
次に LLM で利用できるか確認するために Claude Desktop で実行してみましょう。
Claude Desktop で利用してみよう
Claude Desktop は Anthropic 社が提供する AI チャット アプリ Claude のデスクトップ アプリで、ローカル ファイルや外部ツールとの連携が実現できます。
Claude Desktop でローカルの MCP サーバーを実行するにはいくつか準備が必要です。
ここでは、その準備を行った後に Claude Desktop で ArcGIS Routing MCP を使ってみましょう。
Claude Desktop 側の設定
Claude Desktop へサイン インし、アプリ画面の左下のアイコンをクリックすると設定項目があるのでそちらをクリックします。
設定画面へのクリック
表示されたメニューから 「開発者」 の項目をクリックし、遷移先で「設定を編集」をクリックします。
「設定を編集」をクリック
クリックするとエクスプローラーが起動し、`claude_desktop_config.json` が生成されます。
`claude_desktop_config.json` をコード エディターで開くと空の `{}` が用意されています。
この中括弧を下記のように書き換えます。
{
"mcpServers": {
"arcgis-routing-mcp": {
"command": "<python 環境への絶対パス>\\python.exe",
"args": [
"<スクリプトの絶対パス>\\arcgis_route.py"
]
}
}
}
設定後、 1度 Claude Desktop を閉じる必要がありますが、注意していただきたい点は右上の×ボタンでウィンドウを閉じるのではなく、左上のハンバーガー メニューをクリックして表示される「終了」をクリックし、アプリを完全に終了させる必要があります。Claude Desktop のタスクが残っている状態ですので、タスク マネージャー等から Claude Desktop のタスクを削除しておきます。
Claude Desktop を閉じる手順
ここまで問題なければ再度 Claude Desktop を立ち上げるとチャットの入力欄の `+` ボタンをクリックして出てくるコネクタと設定の「開発者」の項目に ArcGIS Routing MCP が追加されているはずです。
コネクタに追加された様子
「開発者」項目に追加された様子
Claude Desktop で ArcGIS Routing MCP を使ってみる
立ち上げた Claude Desktop で ArcGIS Routing MCP を使ってルート検索をしてみましょう。
動画内でも確認していますが solve_route と書いてあるプルダウン メニューを押すと実際にリクエストした JSON とレスポンスされた JSON が閲覧できます。
最後に出力してもらった結果が正しそうかこのルート検索の結果を GeoJSON 化してもらい、ArcGIS Online の Map Viewerで描画してみましょう。
Claude に GeoJSON 化を依頼
ルートを GeoJSON で書き出した結果
出力された GeoJSON も間違いなさそうです。
ここまでで FastMCP を使うことで ArcGIS のルート検索機能 を LLM で利用できていることを確認できました。
様々な用途が考えられますが、LLM だけでは到達できないタスクを MCP で外部ツールにアクセスすることで達成できるようになりました。
最後に Visual Studio Code でも利用できるか試してみましょう。
Visual Studio Code でも使えるのか
MCP のメリットの 1 つとして挙げられるのは、あらゆる LLM に対応できるという点です。こちらを確認するために Visual Studio Code の GitHub Copilot Chat でも ArcGIS Routing MCP が使えるか試してみました。
Visual Studio Code の設定
Visual Studio Code での設定は GitHub アカウントにあらかじめサイン インをしたうえでGitHub Copilot と GitHub Copilot Chat の拡張機能をインストールしておきます。
上記の設定が完了している状態でしたら MCP サーバーを使えるように `mcp.json` instellen.
`mcp.json` opent de MCP-servermap in Visual Studio Code en maakt het aan in de map `.vscode` binnen dezelfde map.
`mcp.json` is vergelijkbaar met Claude Desktop, maar let op dat er kleine verschillen in details zijn.
{
"servers": {
"arcgis-routing-mcp": {
"type": "stdio",
"command": "<absolute pad naar python-omgeving>\\python",
"args": ["arcgis_route.py"],
}
}
}
Als bovenstaande correct is ingesteld, klik dan op `mcp.json` en je zult zien dat er in de afbeelding `Start` of soortgelijke tekst verschijnt bij `arcgis-routing-mcp`. Klik op `Start`.
Instellingen van mcp.json
Als het script van de gemaakte MCP-server en de beschrijving in `mcp.json` correct zijn, zal bij `Start` de status `Running` worden weergegeven.
Laten we het daadwerkelijk proberen met GitHub Copilot Chatで試してみましょう。
ReferentiesArcGIS REST APIs
ArcGIS Routing Service
ArcGIS Geocoding Service
Model Context Protocol
FastMCPClaude DesktopConnect to local MCP servers
GitHub Copilot Chat