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 分