Bama Cars

io.github.sepehr071由 GitHub 账号 sepehr071 发布v0.2.0更新于 Nov 7, 2026

Read-only Bama (bama.ir) Iran car marketplace: ad search, ad details, market prices, new-car prices.

已验证STDIO仅桌面位置与生活网页搜索与抓取金融

概览

AI 生成的概览

面向伊朗 Bama（bama.ir）汽车交易市场的非官方只读 MCP 服务器，让助手搜索车源广告并查询价格、参数和经销商。

可以做什么
  • 按品牌、车型、年份、价格、里程、城市、卖家等条件搜索二手车、新车、摩托车和卡车广告，并查看单条广告详情
  • 按年份计算某车型的要价统计（最低价、四分位数、中位数、最高价），并查看每日市场评分和涨幅最大的新车
  • 查询新车配置价格及日涨跌与趋势，检索或排序每日新车与摩托车价格表
  • 浏览展厅和某经销商的在售车源，查看技术参数、专家评分、优缺点和配置
  • 查询其他工具所需的品牌、车型、配置和筛选值
适用场景
适合在用户询问伊朗二手车或新车价格、想按车型、年份、里程或城市筛选车源、想比较某车型的要价，或需要查找经销商和展厅时使用。
运行要求
通过 uvx 以 stdio 在本机运行，需要 uv 和 Python 3.10 以上版本。无需 API 密钥或 Bama 账号。需要能访问 Bama 的网络；可选环境变量 BAMA_MCP_PROXY 用于设置 HTTP 代理或逗号分隔的代理列表，系统代理设置会被忽略。
安装前请注意
仅只读：无法登录、发布广告、联系卖家或读取电话号码。价格为以托曼计的要价而非实际成交价，市场统计仅基于最多五页的抽样而非总量。文本为波斯语，年份为伊朗历。该服务器为非官方项目，与 Bama 无关联；若配置了代理，请求会经该代理发出。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Bama Cars，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

bama-ir-mcp: Bama (باما) Iran car marketplace MCP server for AI agents

bama-ir-mcp is an unofficial, read-only MCP server that gives AI agents the car ads and price lists of Bama (bama.ir), Iran's car marketplace.
Its 12 tools search used and new car, motorcycle and truck ads with real filters, read one ad in full, compute asking-price statistics for a model, search and rank the new-car price list, show the daily market mood, return technical specs and expert ratings, browse a dealer's inventory and look up brand, model and filter values.
No API key or Bama account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · Tools · FAQ

For AI agents

  • What: unofficial MCP server (model context protocol) for bama.ir: car ad search (brand/model/trim, year, price, mileage, city, seller, gearbox, body, fuel, color, paint condition, installment), ad details, market price statistics per model and year, new-car price list with trend, dealers and their inventory, motorcycle and truck ads, technical specs and ratings, market pulse.
  • Install: uvx bama-ir-mcp or claude mcp add bama -- uvx bama-ir-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional BAMA_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, post ads, message sellers or read phone numbers.
  • Tools: 12, all prefixed ba_. Typical sequences: ba_vehicles -> ba_search -> ba_ad; ba_vehicles -> ba_market_stats; ba_new_prices / ba_price_list; ba_car_specs; ba_dealers -> ba_dealer_ads; ba_filters -> ba_search.
  • Use when: the user asks what a used or new car costs in Iran, wants listings by model, year, mileage or city, wants to compare asking prices, or needs a dealer.
  • Do not use when: a car outside Iran, or actual sale prices (these are asking prices).
  • Output: compact JSON. Prices are Toman, years Jalali (imports may show Gregorian), mileage km, text Persian.

Quick start

bash
claude mcp add bama -- uvx bama-ir-mcp

Other clients: command uvx, args ["bama-ir-mcp"].

Tools

ToolWhat it does
ba_searchCar ads with filters, 30 per page, sortable.
ba_adOne car, motorcycle or truck ad in full, with the real number of ads for that model; optional similar ads.
ba_market_statsMin, quartiles, median, max asking price for a model, per year, from live ads.
ba_new_pricesToday's price of new-car trims (market, factory, dealer) with daily change and trend.
ba_dealersShowrooms with ads for a model or city, with address and rating.
ba_search_bikes_trucksMotorcycle or truck ads with filters (brand, year, price, city, body, usage...).
ba_dealer_adsOne dealer's inventory (up to 100 ads) with filters and sorting.
ba_price_listSearch and rank the daily new-car or motorcycle price list by brand, price type, origin.
ba_market_pulseToday's market score and analysis plus the biggest new-car price movers.
ba_car_specsTechnical specs, expert rating, pros and cons, trims of a car or motorcycle model.
ba_vehiclesBrand, model and trim values for the other tools (cars, motorcycles, trucks).
ba_filtersValues for region, body, fuel, color, country, truck usage and other filters.

FAQ

Does it need the internet from Iran? Bama answers from inside Iran and through most proxies. Set BAMA_MCP_PROXY to route through one.

Why a sample, not a total? Bama gives no result count and 30 ads per page; ba_market_stats samples up to 5 pages and says so.

Is it allowed? It calls the same public JSON the website uses, serially and with caching. It does not bypass any browser check.

Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard. MIT licensed. Not affiliated with Bama.

来源：README.md，提交 d580332

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

3
  1. v0.2.0最新Nov 7, 2026
  2. v0.1.1Nov 3, 2026
  3. v0.1.0Nov 1, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分