Alexa Shopping List

🚀 Alexa ショッピングリストマネージャー

Alexaのショッピングリストをシームレスに管理します。項目の追加、削除、表示をすぐに行えます。

MCPを通じてClaudeやCursorなどのAIアシスタントと対話し、このツールを使用してAlexaのショッピングリストとローカルで通信できます。

⚠️ 重要提示

このツールは手動での認証とCookieの更新が必要です。

このツールは手動ログインプロセスで抽出したブラウザのCookieを使用します。Amazonのセッションは期限切れになります。ツールが機能しなくなった場合は、定期的にログインスクリプト（手順5と6）を再実行する必要があります。

✨ 主な機能

このツールは以下のコンポーネントで構成されています。

1. APIサーバー（src/api）：FastAPIを使用したDockerコンテナで、Alexaと通信します。
2. MCPサーバー（src/mcp）：ローカルスクリプトでMCPツールを提供し、APIサーバーに代理します。
3. ログインスクリプト（src/auth）：Seleniumを使用して手動ログインとCookie注入を行うローカルスクリプトです。

📦 インストール

前提条件

• Python 3.10以上
• uv（インストール：pip install uv または astral.sh/uv を参照）
• DockerとDocker Compose（またはDocker Desktop）
• Google Chrome（ログインスクリプト用）
• Amazonアカウント（Alexa付き）

セットアップと実行

1. リポジトリをクローンする

# git clone <repository_url>
cd alexa-mcp

2. 設定を編集する src/auth/config.py を編集して、あなたのAmazonの資格情報を反映させます。

AMAZON_EMAIL = "你的亚马逊邮箱"
AMAZON_PASSWORD = "你的亚马逊密码"

3. 依存関係をインストールする プロジェクトのルートディレクトリで以下のコマンドを実行します。

pip install -r src/api/requirements.txt
pip install -r src/auth/requirements.txt
pip install -r src/mcp/requirements.txt

4. APIサーバーを起動する プロジェクトのルートディレクトリから以下のコマンドを実行します。

uvicorn src.api.main:app --reload

デフォルトでは、APIは http://localhost:8000 で利用可能です。

5. MCPサーバーを起動する プロジェクトのルートディレクトリから以下のコマンドを実行します。

uvicorn src.mcp.mcp_server:app --reload

MCPクライアント（Claude Desktop / Cursor）の接続

このサーバーをClaude DesktopやCursorなどのMCPクライアントと一緒に使用するには、クライアントの mcp.json ファイルに設定を追加する必要があります。このファイルは、クライアントがローカルのMCPサーバーを見つけて実行する方法を教えます。

1. MCPクライアントの設定ファイル（通常は mcp.json）を見つけます。クライアントによって場所は異なります。
2. ファイルを開き、メインの "mcpServers": { ... } オブジェクト内に以下のエントリを追加します。

    "alexa-shopping-list": {
        "displayName": "Alexa Shopping List MCP",
        "description": "MCP Server for interacting with Alexa shopping list via local API",
        "command": "/path/to/your/alexa-mcp/.venv/bin/python",
        "args": [
          "-m",
          "src.mcp.mcp_server"
        ],
        "workingDirectory": "/path/to/your/alexa-mcp",
        "env": {
          "PYTHONPATH": "/path/to/your/alexa-mcp"
        }
    }

⚠️ 重要提示

プレースホルダーの絶対パス /path/to/your/alexa-mcp をあなたのコンピュータ上のプロジェクトの実際の絶対パスに置き換える必要があります。また、その場所に .venv 仮想環境が存在し、MCPの依存関係がインストールされていることを確認してください（uv pip install -r src/mcp/requirements.txt を実行）。

3. mcp.json ファイルを保存します。
4. MCPクライアントを再起動します。これで「Alexa Shopping List MCP」サーバーが見つかるはずです。

📄 ライセンス

このツールを気に入ったら、開発者を支援してください。