Stadiamaps MCP Server Ts

🚀 Stadia Maps MCP Server (TypeScript)

このStadia Maps MCP Server (TypeScript) は、Model Context Protocol (MCP)サーバーです。AIアシスタントに対して、位置情報サービス、ジオコーディング、ルート探索、マッピング機能などのStadia Maps APIへのアクセスを提供します。

✨ 主な機能

機能一覧

• 地球上の任意の場所の時間情報
  • 現在時刻
  • タイムゾーン情報（ID、UTCオフセット、夏時間などの特別なオフセットが適用されているかどうか）
• ジオコーディング
  • 住所検索
  • 場所検索（レストランやカフェなどのPOI）
• 静的マップ画像生成（マーカーやルートオーバーレイを含む）
• ルート探索と移動時間
• 等時線（到達可能範囲；時間と距離の等高線）

ユースケース

以下は、大規模言語モデル（LLM）にこれらのツールを使用させるためのいくつかのプロンプト例です。

• "東京の現在時刻は何時ですか？"
• "Depoo TurgからPõhjala Tap Roomまでの徒歩ルートを示すマップを作成してください。"
• "Põhjala Tap Roomは現在営業中ですか？Stadia Mapsを使ってこの情報を取得してください。"
• "添付のスプレッドシート内の住所をジオコードしてください。"

🚀 クイックスタート

ビルド

すべての手順でbunを使用しますが、npmを使用することもできます。

1. bun installを実行して依存関係を取得します。
2. 次に、ビルドスクリプトを実行します：bun run build。

ビルドされたコードはbuildディレクトリに保存されます。

設定

このMCPサーバーにはStadia Maps APIキーが必要です。こちらの手順に従って、無料のAPIキーを取得してください。その後、サーバーを実行する際にAPI_KEY環境変数を設定します。

💻 使用例

基本的な使用法

このMCPサーバーを使用する方法はいくつかあります。以下に具体的な例を示します。

Claude Desktop

Claude DesktopでこのMCPサーバーを設定する詳細な手順については、Claude Desktop Setupを参照してください。Claude Desktopはワークフローをテストするのに便利なツールです。

Warp

WarpでこのMCPサーバーを設定する詳細な手順については、Warp Setupを参照してください。Warpは、LLMを使用してユーザーの代わりに作業を行う強力なエージェント環境です。Claudeにはファイルをアップロードする必要がありますが、Warpは直接ファイルにアクセスし、コードを書き、コンピューター上でプログラムを実行することができます。Stadia Maps MCPと組み合わせることで、大量の住所のジオコーディングやデータセットの空間フィルタリングなどのタスクに強力なツールとなります。

Anthropic SDKを使用したプログラムによる統合

開発者がTypeScriptアプリケーションにMCPサーバーをプログラムで統合したい場合、Anthropic SDK Integration Exampleを参照してください。この例では、以下のことが示されています。

• コードから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個に拡張すると、数万の入力トークンになることがあります。

このプロジェクトは出発点です。全体に、ツールの構築方法や、ユースケースに合わせてカスタマイズする方法についてのコメントを残しています。