楼宇大数据服务

Proporciona consultas completas de información de edificios y direcciones de oficinas, incluyendo búsqueda de direcciones de oficinas empresariales y consultas de información de edificios.

GitHub
2
Prueba este MCPPatrocinado

Documentación

楼宇大数据服务

Este servicio MCP proporciona funciones integrales de consulta de información de edificios y direcciones de oficinas, incluyendo consulta de direcciones de oficinas de empresas, consulta de información de edificios, etc., ayudando a los usuarios a realizar análisis de distribución geográfica y análisis de ocupación de edificios.

Funciones principales

  • 🔍 Búsqueda difusa de palabras clave de empresas
  • 🏢 Consulta de direcciones de oficinas de empresas
  • 📊 Análisis estadístico de direcciones de oficinas
  • 🏗️ Consulta de información de edificios

Requisitos del entorno

  • Python 3.10+
  • Paquetes de dependencias: python-dotenv, requests, mcp

Inicio rápido local

1. Clonar el proyecto

git clone https://github.com/handaas/building-mcp-server
cd building-mcp-server

2. Crear entorno virtual e instalar dependencias

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. Configuración del entorno

Copiar la plantilla de variables de entorno y configurar:

cp .env.example .env

Editar el archivo .env y configurar las siguientes variables de entorno:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar el servicio con streamable-http

python server/mcp_server.py streamable-http

El servicio se iniciará en http://localhost:8000.

Métodos de inicio compatibles: stdio, sse o streamable-http

5. Configuración de MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Instalación e implementación de la versión STDIO

Configurar MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "building-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Usar el servicio remoto oficial

1. Configurar directamente MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "building-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/building/building_bigdata?token={token}"  
      }
  }
}

Nota: integrator_id, secret_id, secret_key y token requieren iniciar sesión en https://www.handaas.com/ para registrarse y obtener acceso a la plataforma

Herramientas disponibles

1. building_bigdata_fuzzy_search

Función: Búsqueda difusa de palabras clave de empresas

Busca listas de empresas relacionadas según palabras clave como nombre de empresa, nombre de persona, marca, producto, puesto, etc.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Consulta empresas cuya información variada contenga la palabra clave
  • pageIndex (Opcional): Posición de inicio de paginación
  • pageSize (Opcional): Posición de fin de paginación - Máximo 50 registros por página

Valor de retorno:

  • total: Total
  • Otra información relacionada con la empresa

2. building_bigdata_office_address_details

Función: Consulta de detalles de direcciones de oficinas de empresas

Según información de identificación específica de la empresa, consulta y devuelve datos relacionados con las direcciones de oficinas de la empresa, incluyendo el número total de direcciones de oficinas, información detallada de direcciones de oficinas por ciudad, etc.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Nombre de empresa / número de registro / código de crédito social unificado / ID de empresa
  • address (Opcional): Región - Admite filtrado por provincia/ciudad, ejemplo de entrada: "广东省,广州市"
  • pageIndex (Opcional): Posición de inicio de paginación
  • keywordType (Opcional): Tipo de entidad - name: nombre de empresa, nameId: ID de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
  • pageSize (Opcional): Posición de fin de paginación - Máximo 10 registros por página

Valor de retorno:

  • total: Total
  • resultList: Resultados de la lista
    • officeAddress: Dirección
    • officeSourceType: Fuente de la dirección
    • officeSettleType: Método de registro - Registro comercial, registro de dirección de oficina
    • estateName: Edificio
    • estateId: ID del edificio

3. building_bigdata_office_address_stats

Función: Análisis estadístico de direcciones de oficinas de empresas

Según información de identificación específica de la empresa, consulta y devuelve datos relacionados con las direcciones de oficinas de la empresa, incluyendo ciudades de oficinas, número de direcciones de oficinas por ciudad, etc.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Nombre de empresa / número de registro / código de crédito social unificado / ID de empresa
  • keywordType (Opcional): Tipo de entidad - name: nombre de empresa, nameId: ID de empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valor de retorno:

  • officeCityStats: Estadísticas de distribución de direcciones de oficinas
    • city: Ciudad de oficinas
    • count: Número de direcciones de oficinas

4. building_bigdata_building_query

Función: Consulta de información de edificios

Admite la consulta de información de todos los edificios en una región específica mediante nombre de edificio, tipo de edificio, etc., incluyendo nombre del edificio, alias del edificio, dirección del edificio, tipo de edificio, número de empresas en el edificio, etc.

Parámetros:

  • matchKeyword (Opcional): Palabra clave de búsqueda - Consulta edificios cuyo nombre o alias contenga la palabra clave
  • pageIndex (Opcional): Posición de inicio de paginación
  • address (Opcional): Región - Admite filtrado por provincia/ciudad, ejemplo de entrada: "广东省,广州市"
  • pageSize (Opcional): Posición de fin de paginación - Máximo 10 registros por página
  • estatePropertyType (Opcional): Tipo de edificio - Oficinas, parque industrial, complejo, apartamento/hotel, centro de exposiciones

Valor de retorno:

  • total: Total
    • estateName: Nombre del edificio
    • estateId: ID del edificio
    • estateAliasName: Alias del edificio
    • estateAddress: Dirección del edificio
    • estatePropertyType: Tipo de edificio
    • estateEnterpriseCount: Número de empresas en el edificio

Casos de uso

  1. Gestión interna de empresas: Conocer la distribución de direcciones de oficinas y edificios
  2. Análisis comercial: Realizar análisis de distribución geográfica de mercado
  3. Instituciones gubernamentales: Verificación de información empresarial o apoyo a la toma de decisiones
  4. Sector inmobiliario: Análisis de ocupación de edificios
  5. Cooperación comercial: Buscar distribución de empresas en áreas específicas
  6. Investigación de mercado: Análisis de actividad comercial regional

Notas de uso

  1. Requisito de nombre completo de la empresa: Al llamar a interfaces que requieren el nombre completo de la empresa, si no se dispone del nombre completo, primero llamar a la interfaz building_bigdata_fuzzy_search para obtenerlo
  2. Límites de paginación: La consulta de direcciones de oficinas obtiene un máximo de 10 registros por página; la búsqueda de empresas obtiene un máximo de 50 registros por página
  3. Filtro por región: Admite filtrado por provincia y ciudad, con formato "provincia,ciudad"
  4. Tipo de edificio: Admite filtrado por tipo como oficinas, parque industrial, complejo, etc.

Ejemplos de preguntas de uso

building_bigdata_fuzzy_search (Búsqueda difusa de palabras clave de empresas)

  1. Ayúdame a buscar información de empresas que contengan la palabra clave "腾讯"
  2. Buscar la lista de empresas relacionadas con "阿里"
  3. Consultar empresas cuyo nombre contenga "抖音"

building_bigdata_office_address_details (Consulta de detalles de direcciones de oficinas de empresas)

  1. Consultar los detalles de direcciones de oficinas de 腾讯科技有限公司
  2. ¿Qué ubicaciones de oficinas tiene 阿里巴巴集团 en Pekín?
  3. Información de direcciones de oficinas de 抖音 en Shanghái

building_bigdata_office_address_stats (Análisis estadístico de direcciones de oficinas de empresas)

  1. Estadísticas de distribución de direcciones de oficinas de 腾讯 en varias ciudades del país
  2. Distribución de ciudades de direcciones de oficinas de 阿里巴巴
  3. Estadísticas del número de direcciones de oficinas de 华为 en varias ciudades

building_bigdata_building_query (Consulta de información de edificios)

  1. Consultar información de oficinas en el distrito de Nanshan, Shenzhen
  2. Buscar edificios de parques industriales en Zhongguancun, Pekín
  3. Buscar información de edificios de complejos en el nuevo distrito de Pudong, Shanghái