Amazon & Flipkart MCP Server

Lightweight MCP (Marketplace Content Proxy) server and tools for interacting with Amazon and Flipkart search/auth components. This repository contains a small service, utilities, and tests used during development.

Repository layout

• main.py — top-level entry (project wrapper).
• pyproject.toml — top-level packaging metadata.
• amazon_flipkart_mcp(1)/amazon_flipkart_mcp/ — primary package directory containing the service and modules:
  • config.py — configuration and settings.
  • server.py — MCP server entrypoint (HTTP/service glue).
  • main.py — package-level runner.
  • models.py — shared data models and DTOs.
  • tools.py — helper CLIs and utilities used in development.
  • utils.py — miscellaneous helper functions.
  • requirements.txt — Python dependencies for the package (if present).
  • amazon/ — Amazon-specific code:
    • auth.py — authentication helpers for Amazon.
    • search.py — search-related code for Amazon.
  • flipkart/ — Flipkart-specific code:
    • search.py — search-related code for Flipkart.
  • logs/ — runtime logs (gitignored in most setups).
  • tests/ — unit tests:
    • test_amazon_auth.py, test_amazon_search.py, test_flipkart_search.py, test_tools.py.

Requirements

• Python 3.10+ recommended.
• Install dependencies (inside the package folder):

cd amazon_flipkart_mcp(1)/amazon_flipkart_mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

If the project uses pyproject.toml for dependency management, use your preferred tool (pip, poetry, etc.).

Configuration

Edit config.py to set API keys, timeouts, or other environment-specific settings. The project expects any secrets or credentials to be provided via environment variables or the local config.py during development.

Running the server (development)

From the package directory run the development server. An example command used during development is:

cd amazon_flipkart_mcp(1)/amazon_flipkart_mcp
uv run fastmcp dev inspector server.py

Adjust the command to match your development runner (for example uvicorn, python -m or a custom uv wrapper used in this repo).

Running tests

Run tests from the package directory:

cd amazon_flipkart_mcp(1)/amazon_flipkart_mcp
pytest -q

Development notes

• The amazon and flipkart subpackages contain marketplace-specific logic — split concerns between authentication and search.
• Use tools.py for developer convenience functions and test scaffolding.
• Keep secrets out of source control; prefer environment variables for keys.

Contributing

Feel free to open issues or pull requests. For local changes, add tests in the tests/ folder and run pytest.

License

Add a license file if you intend to publish this repository. By default, no license is included.