MCP Market Russia

io.github.devids77由 GitHub 帳號 devids77 發布v3.2.0更新於 Oct 24, 2026

Russian construction market: 3,395 contractors, 20,322 projects, 24 search/analytics tools.

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

面向俄羅斯建築市場的託管 MCP 伺服器,讓助理搜尋建築公司與房屋專案、比較價格並送出報價請求。

可以做什麼
依類別、地區、面積、材料與預算搜尋並檢視建築公司與房屋專案,含完整檔案與作品集。跨地區與類別比較公司與價格。估算建造成本並產生市場報告與分析。將自然語言需求媒合為排序後的承包商,並把搜尋結果匯出為 CSV。向公司送出報價請求並查詢潛在客戶狀態。
適用情境
適合調查俄羅斯房屋建築承包商或專案、比較地區價格、估算建造成本,或為俄羅斯建築市場產生潛在客戶與市場報告時使用。
執行需求
遠端 MCP 端點;免費目錄層級無需註冊或 API 金鑰。付費的分析與 AI 工具層級需要 API 金鑰,透過 X-API-Key 標頭或 api_key 查詢參數傳入。需要能存取該託管服務的網路。
安裝前請注意
request_quote 會代表使用者向公司送出報價請求,包含客戶姓名與聯絡方式,並建立潛在客戶;get_lead_status 需要建立潛在客戶時所用的 api_key。付費層級按月收費。目錄資料彙整自 2GIS、Avito、Yandex 等公開來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MCP Market Russia,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.devids77%2Fmcp-market-ru/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "market-russia": {
      "type": "http",
      "url": "https://mcp-market.ru/mcp/"
    }
  }
}

README

MCP Market Russia 🏗️

MCP server for the Russian construction and real estate market. Search 3,395 construction companies, browse 4,468 house projects, compare prices, request quotes — all via the Model Context Protocol or REST API.

[Live] [Stats] [Projects] [License]

Listed in the official MCP Registry as io.github.devids77/mcp-market-ru.

What this is

A live, hosted MCP server that gives AI agents (Claude Desktop, Cursor, Cline, Continue, etc.) direct access to a curated catalog of Russian construction companies and home-building projects, complete with pricing, ratings, regions, photos and contact info aggregated from public sources.

No registration needed for the basic catalog — point your MCP client at https://mcp-market.ru/mcp and start asking questions.

Quick start — Claude Desktop

Open your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: `%APPDATA%\Claude\claude_desktop_config.json

Add:

json
{  "mcpServers": {    "mcp-market": {      "url": "https://mcp-market.ru/mcp"    }  }}

Restart Claude Desktop. The 24 tools are now available — Claude will call them automatically when you ask construction-related questions.

Quick start — Cursor

Settings → MCP → Add new MCP server. URL: https://mcp-market.ru/mcp

Quick start — REST API

Free tier works without an API key:

bash
# Search companiescurl "https://mcp-market.ru/api/v1/search/companies?q=каркасные+дома+в+спб"
# Get a specific companycurl "https://mcp-market.ru/api/v1/companies/<company_id>"
# Search projects by area and budgetcurl "https://mcp-market.ru/api/v1/search/projects?q=брус+150&min_price=3000000"
# Catalog statscurl "https://mcp-market.ru/api/dashboard/stats"

Paid tiers (Analytics, AI Tools) require an API key — pass it as X-API-Key header or ?api_key= query param.

What you can ask

Example prompts that work well with the MCP server:

  • "Find frame houses (каркасные дома) in Moscow region under 12 million rubles"
  • "Compare timber (брус) projects between 120-150 m²"
  • "Show top-10 companies in Krasnodar region by rating"
  • "Send a quote request to company X with my contact details"
  • "What's the average price per m² for monolith houses in St Petersburg?"

The server supports both Russian and English queries with proper synonym handling for Russian regions (спб → Saint Petersburg, мск → Moscow, etc.) and construction terminology.

Available tools

ToolTierDescription
search_companiesFreeSearch construction companies by category, region, budget, tags
search_projectsFreeSearch house projects by area, price, material
get_companyFreeFull company details with all projects
get_projectFreeComplete project card (specs, price, photos)
get_categoriesFreeList all company categories with counts
get_regionsFreeList all regions with company counts
get_statsFreeCatalog statistics
smart_matchFreeMatch companies to budget + region + category
request_quoteFreeSend a lead/quote request to a company
compareFreeCompare multiple companies side-by-side
calculateFreeProject cost estimator
analytics/marketStarterRegional market analytics
analytics/best-companiesStarterTop companies with extended metrics
analytics/price-comparisonStarterPrice comparison across segments
analytics/reportStarterFull analytical report
ai/recommendProAI recommendations for client criteria
ai/estimateProAI cost estimate from project description
ai/reviewsProAI-summarized reviews per company
ai/trendsProAI market trend analysis
ai/deep-profileProDeep company profile with insights
ai/region-compareProAI comparison of regions

Pricing

PlanPriceRequests/dayTools
Free₽010024 (all Free-tier tools)
Starter₽2 990/mo1 00024 + Analytics
Pro₽7 990/mo5 00024 + Analytics + AI Tools
Enterprise₽24 990/mounlimited24 + custom, SLA, white-label

Get a key at https://mcp-market.ru/pricing.

Data

  • 3,395 companies aggregated from public sources (2GIS, Avito, construction catalogs, Yandex)
  • 4,468 projects with specs, materials, area, price, photos
  • 18 regions covered (Moscow, St Petersburg, Krasnodar, Yekaterinburg, …)
  • 67% tagged via regex + GLM-4.6 classifier — search by tag works for queries like "bath house in Krasnodar"
  • Live data: companies and projects refreshed periodically; check /dashboard for current counts

For construction companies

Your company is already in the catalog? Claim your profile to:

  • Edit your description, photos, and contact info
  • Add detailed project portfolios
  • Receive leads from AI agents directly to your inbox + Telegram
  • Get analytics on which AI queries reached your card

Email [email protected] to claim.

Architecture

  • FastAPI + FastMCP for HTTP + MCP transport layered on the same /mcp/ endpoint
  • PostgreSQL 16 with full-text + GIN-indexed tag array
  • Docker Compose deployment
  • Nginx + Let's Encrypt for HTTPS termination
  • Single-flight cache on heavy endpoints (dashboard/overview is 30s)

Links

Error codes

CodeMeaning
200OK
400Bad request parameters
401API key required for this endpoint
403Your plan doesn't cover this endpoint
404Not found
429Daily request limit exceeded
500Server error — report to [email protected]

License

MIT

來源:README.md,提交 dca8f54

工具

24

search_companies

Search Russian construction companies by category, region, and budget. Returns company name, rating, prices, website, and phone number. Args: query: Free text search query (e.g. 'каркасные дома недорого', 'frame houses') category: Company category filter (каркасные_дома, дома_из_бруса, газобетон, кирпич, недвижимость, модульные_дома, СИП) region: Region or city name (e.g. 'Московская область', 'Санкт-Петербург', 'Краснодар') budget_max: Maximum budget in rubles. Set to 0 for no limit. limit: Number of results to return, maximum 20

輸入參數limitqueryregioncategorybudget_max

search_projects

Search house building projects by area, floors, material, and price. Returns project specifications, price, direct link, and company contacts. Args: area_min: Minimum house area in square meters. Set to 0 for no limit. area_max: Maximum house area in square meters. Set to 0 for no limit. floors: Number of floors/stories. Set to 0 for any. material: Building material filter (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP) budget_max: Maximum price in rubles. Set to 0 for no limit. region: Filter by company region or city name query: Free text search in project name and description limit: Number of results to return, maximum 20

輸入參數limitqueryfloorsregionarea_maxarea_minmaterialbudget_max

compare_companies

Compare 2-3 construction companies side by side on prices, ratings, number of projects, and specialization. Args: company_ids: Comma-separated company UUIDs to compare (2-3 IDs). Example: 'uuid1,uuid2,uuid3'

輸入參數company_ids必填

calculate_cost

Calculate estimated construction cost based on real market data from the catalog. Uses average price per m² by material and region from actual company prices and projects. Args: area: House area in square meters (required, e.g. 120) material: Building material (каркас/frame, брус/timber, газобетон/aerated_concrete, кирпич/brick, СИП/SIP). Empty = average across all. region: Region or city name for regional pricing. Empty = nationwide average. floors: Number of floors (1 or 2). 0 = no adjustment.

輸入參數area必填floorsregionmaterial

get_company

Get full company profile including contacts, prices, rating, reviews, and list of house projects. Args: company_id: Company UUID from search_companies results

輸入參數company_id必填

get_project

Get detailed house project information including specifications, price, features, and company contacts. Args: project_id: Project UUID from search_projects results

輸入參數project_id必填

get_categories

Get all company categories with the number of companies in each category.

無需輸入參數。

get_regions

Get all available regions with the number of companies in each region.

無需輸入參數。

get_stats

Get catalog statistics: total companies, projects, regions, categories, agent queries today, and leads generated.

無需輸入參數。

request_quote

Send a quote request to a construction company on behalf of the user. Returns confirmation with lead ID and company contact details. Args: company_id: Target company UUID (required) project_id: Specific project UUID if the user is interested in a particular house project name: Client's name for the quote request phone: Client's phone number for callback email: Client's email address comment: Additional comments or requirements for the quote

輸入參數nameemailphonecommentcompany_id必填project_id

market_analytics

Get comprehensive market analytics for the Russian construction market. Returns: average prices, top companies by rating, market size, price distribution. Perfect for investors, analysts, and companies entering the market. Args: region: Filter by region (e.g. 'Москва', 'Санкт-Петербург'). Empty = all regions. category: Filter by category (e.g. 'Строительство домов'). Empty = all categories.

輸入參數regioncategory

find_best_companies

Smart lead generation: find the best construction companies matching your criteria. Perfect for finding contractors, generating leads, or market research. Args: region: Filter by region name (e.g. 'Москва'). Empty = all. category: Filter by category/subcategory. Empty = all. min_rating: Minimum rating (0-5). 0 = no filter. max_price: Maximum price per m2 in thousands RUB. 0 = no filter. min_price: Minimum price per m2 in thousands RUB. 0 = no filter. has_phone: Only companies with phone number. has_projects: Only companies with project portfolio. sort_by: Sort by: 'rating', 'price_asc', 'price_desc', 'reviews', 'projects'. limit: Max results (1-50).

輸入參數limitregionsort_bycategoryhas_phonemax_pricemin_pricemin_ratinghas_projects

price_comparison

Compare construction prices across regions and categories. Returns detailed price statistics, percentiles, and regional rankings. Args: regions: Comma-separated regions to compare (e.g. 'Москва,Санкт-Петербург'). Empty = all. category: Filter by category. Empty = all.

輸入參數regionscategory

company_portfolio

Get FULL company portfolio: details, all projects, prices, reviews, contacts. Comprehensive dossier for due diligence or hiring decisions. Args: company_slug: Company slug identifier (from search results).

輸入參數company_slug必填

market_report

Generate a comprehensive market report for a specific region. Includes: market size, price tiers, top players, contact availability, competitive landscape. Perfect for investors, business development, and market entry analysis. Args: region: Region name (e.g. 'Москва', 'Ленинградская область').

輸入參數region必填

review_analysis

Reputation summary from the aggregate star rating and review count, benchmarked against the region average. Provide company_slug for one company, or region/category for a market overview. Review texts are not stored, so no per-review sentiment or themes are returned.

輸入參數regioncategorycompany_slug

contractor_recommendation

AI-powered contractor recommendation. Finds the best matching companies based on budget, region, quality requirements. Returns ranked list with match scores.

輸入參數regioncategorybudget_maxbudget_minmin_ratingneed_contactsneed_portfolio

project_estimator

Estimate construction project cost based on area, region, category and quality level (economy/standard/premium). Uses real market data from our database.

輸入參數regionqualityarea_sqm必填category

trend_analyzer

Current market snapshot by region, category, rating tier and price segment. This is a distribution of the catalogue as it stands now, not a time series: we do not store historical snapshots, so no growth or change-over-time can be computed. `period` is accepted for backwards compatibility and ignored.

輸入參數periodregioncategory

company_deep_profile

Get comprehensive company profile with all available data - contacts, projects, pricing, reviews analysis, market position, and comparison with competitors in same region.

輸入參數slug必填

region_comparison

Compare construction markets across regions. Provide comma-separated region names. Shows companies count, ratings, prices, contact availability for each region side by side.

輸入參數regions必填category

export_search_csv

Export search results as CSV text (UTF-8 with BOM, Excel-friendly). entity: 'companies' or 'projects' query: free-text search in name/description category, region: filter fields budget_max: for companies, cap on min_project_price limit: 1..2000 rows (default 500) Returns CSV text ready to save as .csv and open in Excel.

輸入參數limitqueryentityregioncategorybudget_max

smart_match

Natural-language contractor search. Pass a free-form Russian brief (e.g. "хочу каркасный дом 180 кв.м в Подмосковье до 15 млн") and get top-N matching contractors plus an explanation of how the brief was parsed. Returns JSON with: parsed filters, matches list, explanation.

輸入參數brief必填top_n

get_lead_status

Check the status of a lead created via request_quote. lead_id: UUID returned by request_quote api_key: the api_key used when the lead was created Returns JSON with status (new/contacted/won/lost), company info, contact fields, budget, timestamps.

輸入參數api_key必填lead_id必填

版本歷史

1
  1. v3.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分