Stadiamaps MCP Server Ts

🚀 Stadia Maps MCP服務器（TypeScript）

這是一個模型上下文協議（MCP）服務器，它能讓AI助手訪問Stadia Maps的API，以提供位置服務、地理編碼、路線規劃和地圖繪製等功能。

🚀 快速開始

構建

我們將使用 bun 來執行所有指令，但你也可以使用 npm。

1. 運行 bun install 來獲取依賴項。
2. 然後，執行構建腳本：bun run build。 構建後的代碼現在應該位於 build 目錄中。

配置

此MCP服務器需要一個Stadia Maps API密鑰。請按照此處的說明獲取你的免費密鑰。然後，在運行服務器時設置 API_KEY 環境變量。

✨ 主要特性

功能

• 全球時間信息
  • 當前時間
  • 時區信息（ID、UTC偏移量以及是否處於特殊偏移狀態，如夏令時/夏季時間）
• 地理編碼
  • 地址查詢
  • 地點搜索（如餐廳、咖啡館等興趣點）
• 靜態地圖圖像生成（包括標記和路線覆蓋）
• 路線規劃與旅行時間
• 等時線（可達範圍；包括時間和距離輪廓）

使用場景

以下是一些你可以提示大語言模型（LLM）使用這些工具的方式：

• “東京現在幾點了？”
• “為我製作一張顯示從Depoo Turg到Põhjala Tap Room步行路線的地圖。”
• “Põhjala Tap Room現在開門了嗎？使用Stadia Maps獲取此信息。”
• “對附件電子表格中的地址進行地理編碼。”

💻 使用示例

集成示例

有了API密鑰後，以下是幾種使用MCP服務器的方法：

Claude Desktop

有關如何使用Claude Desktop配置此MCP服務器的詳細說明，請參閱Claude Desktop設置。Claude Desktop是測試工作流程的好工具。

Warp

有關如何使用此MCP服務器設置Warp的詳細說明，請參閱Warp設置。Warp是一個強大的智能環境，它使用大語言模型（LLM）為你完成各種任務。與你需要將文件上傳到Claude不同，Warp可以直接訪問文件、編寫代碼並在你的計算機上執行程序。與Stadia Maps MCP結合使用時，它是進行批量地理編碼、空間過濾數據集等任務的強大工具。

使用Anthropic SDK進行編程集成

對於希望將MCP服務器以編程方式集成到其TypeScript應用程序中的開發人員，我們提供了一個Anthropic SDK集成示例。此示例展示瞭如何：

• 從你的代碼連接到MCP服務器
• 與Claude的API集成以進行自然語言查詢
• 通過MCP服務器使用Stadia Maps API為Claude添加空間智能

📚 詳細文檔

技巧與竅門

大語言模型（LLM）遠非完美，有時你需要精心設計提示才能獲得良好的結果。

儘可能明確指定要使用的工具

有時，模型需要一些提示才能使用正確的工具。例如，如果你詢問營業時間，許多模型會嘗試在網上搜索。但模型並不總是能輕易在網上找到這些信息。

例如，看看模型在這裡的表現：

你可以像這樣提示模型使用此MCP中的工具：

發揮創造力

大語言模型（LLM）功能強大，但並非無所不能。例如，讓我們看看如何批量對電子表格中的地址進行地理編碼。

首先，在Claude Desktop中附加一個Excel表格，其中一列包含一些地址。

提示：對這個電子表格中的所有地址進行地理編碼。將地理編碼後的緯度和經度作為新列添加到表格中。

在撰寫本文時，Claude無法直接生成電子表格附件，但它可以生成HTML頁面或其他代碼來為你生成電子表格！實際上，Claude Desktop可能會詢問你是否需要下載Excel表格，但它會直接為你生成。

這種創造力是必要的，特別是當通過常規用戶界面與當前一代大語言模型（LLM）進行交互時。MCP的強大之處在於你可以通過代碼與它們進行交互，這可以克服一些限制，提供令人愉悅的用戶體驗。

自定義！

就像人類一樣，大語言模型（LLM）在獲得適合工作的工具時表現更好。就像一位熟練的工匠一樣，你可能需要一些專業知識來了解如何最好地組合合適的工具和材料。

此外，模型有上下文限制。雖然有一些高級技術可以突破這個限制，但根據你需要的特定API功能定製MCP只會對你有益。更不用說，僅使用特定上下文中所需的工具進行操作會便宜得多。在一個簡單的演示中，工具架構是上下文成本的主要部分！ 如果你將工具套件擴展到約10個工具，最終可能會有數千個輸入令牌。

這個項目是一個起點，我們在中添加了註釋，說明了我們構建工具的方法，以及你如何根據自己的用例進行定製。