market-fiyati

Market Fiyatı MCP Server exposes the search functionality of marketfiyati.org.tr as MCP-compatible tools. It offers three primary tools to interact with product data: search_product for keyword-based product discovery, search_product_by_identity to fetch details by a unique identity such as a barcode or internal ID, and search_similar_products to find items related to a reference product. Clients can invoke these tools through MCP protocol requests and receive both human-readable summaries and the full structured API responses for further processing. The server is designed to integrate with MCP clients and support optional location parameters to enable distance-based searches when relevant.

Prerequisites:

• Python 3.12+
• uv (recommended for project and virtual environment management)

Installation steps:

1. Clone the repository: git clone https://github.com/mtcnbzks/market-fiyati-mcp-server.git cd market-fiyati-mcp-server

2. Create and activate a virtual environment, then install dependencies using uv: uv venv uv sync

3. Run the server locally to verify: uv run python -m market_fiyati_mcp_server.server

4. Optional: Install into an MCP client or set up in your mcp.json using the provided configuration example: uv run mcp install src/market_fiyati_mcp_server/server.py

Prerequisites note: Ensure Python 3.12+ is installed and accessible in your PATH, and that uv is available for environment management.

Tips and common considerations:

• Environment: No special environment variables are required by default. You can add config values via the mcp.json servers section if your deployment requires it.
• If you encounter issues connecting from an MCP client, ensure the server is reachable at the expected host/port configured by your MCP client and that the client supports the MCP tools provided by this server.
• The tools return both a human-readable summary and the full structured API response; use the structured data for programmatic processing in downstream applications.
• When deploying, consider using uvx with your package namespace if packaging the MCP server for distribution.
• Validate identity types (id vs barcode) when using search_product_by_identity to ensure accurate retrieval.