Marketfiyati MCP 服务器
一个用于访问土耳其市场产品价格的模型上下文协议（MCP）服务器 marketfiyati.org.tr 翻译为中文可以是“市场价格.org.tr”（注：这里的“.org.tr”是土耳其的域名后缀，表示这是一个位于土耳其的非营利组织网站，但中文翻译中通常不直接翻译域名后缀，除非需要特别说明）。不过，为了更贴近中文表达习惯，有时也会简化为“市场价网站.org.tr”（但需注意，实际翻译时可能不需要完全翻译整个网址，具体取决于上下文和使用目的）。在这里，为了简洁明了，可以翻译为“市场价网站（土耳其）”或直接保留原网址形式（若网址本身具有识别性）。但最直接的翻译还是“市场价格.org.tr”该服务器提供了一个标准化的API，用于在不同土耳其超市连锁（BIM、A101、Migros、SOK等）中搜索产品并比较价格。
免责声明
这是一个 教育项目 为学习目的而创建。它是 非用于商业用途所有数据均来源于 marketfiyati.org.tr 翻译为中文可以是“市场价格网.org.tr”（注：实际翻译时，网站域名通常保留原样，这里仅对域名前的部分进行翻译说明，实际使用时“org.tr”作为域名后缀仍保持不变）。但更自然的表达可能是直接说“marketfiyati.org.tr（市场价格网站）”，其中“市场价格网站”是对“marketfiyati”的意译，而“.org.tr”则作为土耳其的域名后缀保留原样请尊重他们的服务条款，并负责任地使用此项目。
特点/功能
- 🔍 按关键词和类别搜索产品
- 📍 基于位置的搜索，查找附近店铺
- 🏪 多市场价格比较
- 💰 价格追踪和单价计算
- 🚀 快速响应，智能缓存
- 🔌 兼容MCP，便于与AI工具轻松集成
安装
使用 Docker（推荐）
# 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服务器将在
手动安装
# 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 8000API 端点
服务器提供以下端点：
- POST /按类别搜索 - 使用详细过滤器（关键词、位置、仓库ID）搜索产品
- GET /按类别搜索 - 通过查询参数进行简单的产品搜索
- 获取 /health（资源） - 健康检查端点（包含版本信息）
- 获取 /version（即请求版本信息） - 获取API版本
- 获取 /docs（或“访问 /docs”） 交互式API文档（Swagger UI）
- GET /mcp 翻译为中文是：“获取 /mcp（资源或页面）”。不过，具体翻译可能需要根据上下文来确定“/mcp”所代表的具体含义，因为“/mcp”本身可能是一个特定的路径或资源标识符，在不同的应用或系统中有不同的解释。在没有具体上下文的情况下，上述翻译是一个较为通用的表述 - 用于AI工具集成的MCP协议端点
如需详细的API文档，请访问 启动服务器后。
SOCKS 代理配置
服务器支持所有对外API调用至marketfiyati.org.tr时的SOCKS代理。当你需要通过代理服务器路由请求时，这非常有用。
支持的代理类型
- SOCKS5（推荐）：
socks5://host:port - 带认证的SOCKS5：
socks5://username:password@host:port - SOCKS4：
socks4://host:port
配置方法
环境变量
设定 SOCKS_PROXY 在启动服务器之前设置环境变量：
# 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 8000Docker
将代理配置作为环境变量传递：
docker run -d -p 8000:8000 \
-e SOCKS_PROXY=socks5://localhost:1080 \
--name marketfiyati-mcp \
ghcr.io/yibudak/marketfiyati_mcp:latest示例代理配置
# 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使用SSH创建SOCKS代理
你可以使用SSH创建一个本地SOCKS5代理：
# 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与Claude Desktop配合使用
在您的Claude桌面配置文件中添加以下配置：
macOS（苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"marketfiyati": {
"url": "http://localhost:8000/mcp"
}
}
}添加配置后，重启Claude桌面程序。MCP服务器将可供用于产品价格搜索。
许可证
此项目遵循MIT许可证进行授权。
致谢
支持
对于问题和疑问，请在（相关平台）上提交一个议题 。