Location MCP Server

🚀 位置 MCP サーバ

このサーバは、ローカルの macOS アプリケーションから位置データを提供する MCP（モデルコンテキストプロトコル）サーバです。

🚀 クイックスタート

✨ 主な機能

このサーバは、macOS アプリケーションから位置データを取得し、Claude Desktop などのアプリケーションに提供することができます。

📦 インストール

以下のコマンドを使用して、グローバルにインストールすることができます。

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

または、直接実行することもできます。

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 で、[製品] -> [ビルドフォルダを Finder で表示] を選択します。
3. ここで、Products/Debug/location-getter-agent.app を見つけて、index.ts があるフォルダと同じ場所に貼り付けます。
4. npm i、npm run build、npm run start を実行します。