Market Fiyatı

Provides MCP-compatible search APIs for marketfiyati.org.tr to perform product searches, by identity, and similarity queries.

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mtcnbzks-market-fiyati-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "market_fiyati_mcp_server.server"
      ]
    }
  }
}

This MCP server exposes the search functionality of marketfiyati.org.tr as MCP-compatible tools, enabling you to query products by keywords, identity, and by finding similar items from your client.

How to use

You connect to the Market Fiyatı MCP Server from an MCP-compatible client to perform product searches. The server runs locally using the uv tool, and you can start it so your client can send search requests and receive structured results. Typical workflows include searching by keywords, retrieving product details by a specific identity like a barcode or internal ID, and discovering items similar to a reference product. Use the client tools to invoke the available endpoints and handle the returned structured data.

How to install

Prerequisites: You need Python 3.12 or newer and the uv tool for managing the project and virtual environments.

Clone the MCP server repository.

git clone https://github.com/mtcnbzks/market-fiyati-mcp-server.git
cd market-fiyati-mcp-server

Create a virtual environment and install dependencies using uv.

uv venv
uv sync

Start the MCP server so your client can connect.

uv run python -m market_fiyati_mcp_server.server

Configuration and usage notes

To connect from a client, you can either run the server locally as shown above or configure your MCP client to see the local server. If your client supports a JSON configuration for MCP servers, you can add a local stdio server entry so the client can launch it directly.

Example configuration for a client that launches the server locally (add this to your mcp.json under the servers object):

{
  "servers": {
    "market-fiyati": {
      "command": "uvx",
      "args": ["market-fiyati-mcp-server"]
    }
  }
}

Available tools

search_product

Search for products using keywords with optional location-based filters. Returns a human-readable summary and the full structured API response.

search_product_by_identity

Retrieve product information by a unique identity such as barcode or internal ID, with optional keywords and location-based filters.

search_similar_products

Find products similar to a given reference product ID, with optional keywords and location-based filters.