GitBucket
|
|
|||
|---|---|---|---|
| src/ vmk_data_mcp | 1 day ago | ||
| tests | 1 day ago | ||
| .env.example | 1 day ago | ||
| .gitignore | 1 day ago | ||
| Dockerfile | 1 day ago | ||
| README.md | 1 day ago | ||
| docker-compose.yml | 1 day ago | ||
| plan.md | 1 day ago | ||
| pyproject.toml | 1 day ago | ||
README.md
VMK Data MCP Server
MCP-сервер для поиска по базе данных недвижимости (vmk_data). Предоставляет AI-агенту (Claude) инструменты для:
- семантического (векторного) поиска через pgvector + HNSW
- полнотекстового поиска через готовую FTS-колонку (украинский конфиг)
- фильтрации по метаданным (цена, район, комнаты, метро и т.д.)
- пагинации и сортировки по релевантности
Транспорт
Streamable HTTP (MCP 2025 spec) на порту 8080, endpoint /mcp. Поддерживает как GET (SSE-стрим), так и POST (отправка сообщений).
Инструменты
| Инструмент | Описание |
|---|---|
search_similar_listings |
Векторный поиск по смыслу запроса + фильтры |
search_by_metadata |
Полнотекстовый поиск (FTS) + фильтры |
get_listing_by_id |
Получить объявление по ID |
describe_schema |
Описание схемы БД для AI-агента |
Язык
База данных содержит украинский текст. Все запросы должны быть на украинском — AI-агент сам переводит запрос пользователя перед вызовом инструмента.
Запуск
Локально (для разработки)
# .env скопирован из .env.example и отредактирован pip install -e "." python -m vmk_data_mcp.main
Docker
docker-compose up --build
Зависимости
- Python 3.11+
- PostgreSQL 15+ с
pgvectorextension - Ollama (
nomic-embed-text, 768d) на192.168.1.75:11434
Безопасность
- Read-only пул соединений (only SELECT / WITH / VALUES / EXPLAIN)
- Параметризованные запросы (SQL-инъекции невозможны)
- Белый список колонок (
USER_COLUMNS) - Таймаут запросов (30 сек)