Skip to main content
Glama

Marketfiyati MCP Server

by yibudak
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Marketfiyati MCP Server

A Model Context Protocol (MCP) server for accessing Turkish market product prices from marketfiyati.org.tr. This server provides a standardized API for searching products across different Turkish supermarket chains (BIM, A101, Migros, SOK, etc.) and comparing prices.

Disclaimer

This is an educational project created for learning purposes. It is not intended for commercial use. All data is sourced from marketfiyati.org.tr. Please respect their terms of service and use this project responsibly.

Features

  • 🔍 Search products by keywords and categories

  • 📍 Location-based search with nearby stores

  • 🏪 Multi-market price comparison

  • 💰 Price tracking and unit price calculations

  • 🚀 Fast response with intelligent caching

  • 🔌 MCP-compatible for easy integration with AI tools

Installation

Using Docker (Recommended)

# Pull the pre-built image docker pull ghcr.io/yibudak/marketfiyati_mcp:latest # Run the container docker run -d -p 8000:8000 --name marketfiyati-mcp ghcr.io/yibudak/marketfiyati_mcp:latest # Run with SOCKS proxy (optional) docker run -d -p 8000:8000 -e SOCKS_PROXY=socks5://localhost:1080 --name marketfiyati-mcp ghcr.io/yibudak/marketfiyati_mcp:latest

The server will be available at http://localhost:8000

Manual Installation

# Clone the repository git clone https://github.com/yibudak/marketfiyati_mcp.git cd marketfiyati_mcp # Install dependencies pip install -r requirements.txt # Run the server uvicorn app.main:app --port 8000 # Run with SOCKS proxy (optional) SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000

API Endpoints

The server provides the following endpoints:

  • POST /search_by_categories - Search products with detailed filters (keywords, location, depot IDs)

  • GET /search_by_categories - Simple product search via query parameters

  • GET /health - Health check endpoint (includes version info)

  • GET /version - Get API version

  • GET /docs - Interactive API documentation (Swagger UI)

  • GET /mcp - MCP protocol endpoint for AI tool integration

For detailed API documentation, visit http://localhost:8000/docs after starting the server.

SOCKS Proxy Configuration

The server supports SOCKS proxy for all external API calls to marketfiyati.org.tr. This is useful when you need to route requests through a proxy server.

Supported Proxy Types

  • SOCKS5 (recommended): socks5://host:port

  • SOCKS5 with authentication: socks5://username:password@host:port

  • SOCKS4: socks4://host:port

Configuration Methods

Environment Variable

Set the SOCKS_PROXY environment variable before starting the server:

# Linux/macOS export SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000 # Windows (PowerShell) $env:SOCKS_PROXY="socks5://localhost:1080" uvicorn app.main:app --port 8000 # Windows (Command Prompt) set SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000

Docker

Pass the proxy configuration as an environment variable:

docker run -d -p 8000:8000 \ -e SOCKS_PROXY=socks5://localhost:1080 \ --name marketfiyati-mcp \ ghcr.io/yibudak/marketfiyati_mcp:latest

Example Proxy Configurations

# Local SOCKS5 proxy (e.g., SSH tunnel) SOCKS_PROXY=socks5://localhost:1080 # Remote SOCKS5 proxy with authentication SOCKS_PROXY=socks5://myuser:mypass@proxy.example.com:1080 # SOCKS4 proxy SOCKS_PROXY=socks4://proxy.example.com:1080

Creating a SOCKS Proxy with SSH

You can create a local SOCKS5 proxy using SSH:

# Create an SSH tunnel that acts as a SOCKS5 proxy on port 1080 ssh -D 1080 -C -N user@remote-server.com # Then run the server with the proxy SOCKS_PROXY=socks5://localhost:1080 uvicorn app.main:app --port 8000

Using with Claude Desktop

Add the following configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "marketfiyati": { "url": "http://localhost:8000/mcp" } } }

After adding the configuration, restart Claude Desktop. The MCP server will be available for product price searches.

License

This project is licensed under the MIT License.

Acknowledgments

Support

For issues and questions, please open an issue on GitHub.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yibudak/marketfiyati_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server