Location MCP Server

Location MCP サーバー

ローカルの macOS アプリから位置情報を提供する MCP（Model Context Protocol）サーバーです。

前提条件

• macOS（このパッケージは macOS アプリを起動します）
• Node.js 16 以降

インストール

npm install -g @sokyran/location-mcp-server

または、npx で直接実行します。

npx @sokyran/location-mcp-server

Claude Desktop での使用方法

1. location-getter-agent.app をダウンロードし、コマンドを実行するディレクトリと同じ場所に配置します。

2. Claude Desktop の設定ファイルを編集します。

{
  "mcpServers": {
    "location": {
      "command": "npx",
      "args": ["@sokyran/location-mcp-server"]
    }
  }
}

3. Claude Desktop を再起動します。

4. Claude との会話で getCurrentLocation ツールを使用できるようになります。

仕組み

サーバーは次の処理を行います。

1. location-getter-agent.app を起動します（現在のディレクトリに配置されている必要があります）。
2. アプリがポート 8080 で HTTP サーバーを起動するまで待機します。
3. Claude に getCurrentLocation ツールを公開します。
4. ツールが呼び出されると、ローカルアプリから位置情報を取得して返します。

トラブルシューティング

• location-getter-agent.app が、コマンドを実行しているディレクトリと同じ場所にあることを確認してください。
• 権限エラーが発生する場合は、「システム設定」>「プライバシーとセキュリティ」でアプリを許可する必要がある場合があります。
• ポート 8080 が別のアプリケーションによって使用されていないことを確認してください。

手順

1. Xcode で location-getter をビルドします。
2. Xcode で「Product」->「Show build folder in Finder」を選択します。
3. ここで Products/Debug/location-getter-agent.app を見つけ、index.ts のすぐ近くにあるこのフォルダー内に貼り付けます。
4. npm i、npm run build、npm run start を実行します。