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 分