楼宇大数据服务

Fornece consultas abrangentes de informações de endereços de edifícios e escritórios, incluindo

Documentação

Serviço de Big Data de Edifícios

Este serviço MCP fornece funcionalidades abrangentes de consulta de informações sobre edifícios e endereços comerciais, incluindo consulta de endereços comerciais de empresas, consulta de informações de edifícios, etc., ajudando os usuários a realizar análises de distribuição geográfica e análises de ocupação de edifícios.

Principais Funcionalidades

  • 🔍 Pesquisa difusa por palavras-chave de empresas
  • 🏢 Consulta de endereços comerciais de empresas
  • 📊 Análise estatística de endereços comerciais
  • 🏗️ Consulta de informações de edifícios

Requisitos de Ambiente

  • Python 3.10+
  • Pacotes de dependência: python-dotenv, requests, mcp

Início Rápido Local

1. Clonar o Projeto

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

2. Criar Ambiente Virtual e Instalar Dependências

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

3. Configuração do Ambiente

Copie o modelo de variáveis de ambiente e configure:

cp .env.example .env

Edite o arquivo .env e configure as seguintes variáveis de ambiente:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar o Serviço via streamable-http

python server/mcp_server.py streamable-http

O serviço será iniciado em http://localhost:8000.

Métodos de inicialização suportados: stdio, sse ou streamable-http

5. Configuração do MCP no Cursor / Cherry Studio

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

Instalação e Implantação da Versão STDIO

Configurar o MCP no 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 o Serviço Remoto Oficial

1. Configurar diretamente o MCP no Cursor / Cherry Studio

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

Observação: integrator_id, secret_id, secret_key e token precisam ser obtidos fazendo login em https://www.handaas.com/ para registrar e ativar a plataforma

Ferramentas Disponíveis

1. building_bigdata_fuzzy_search

Função: Pesquisa difusa por palavras-chave de empresas

Pesquisa difusa por palavras-chave como nome da empresa, nome de pessoa, marca, produto, cargo, etc., para retornar uma lista de empresas relacionadas.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - Consulta empresas cujas informações contenham a palavra-chave correspondente
  • pageIndex (opcional): Posição inicial da paginação
  • pageSize (opcional): Posição final da paginação - Máximo de 50 registros por página

Valores de retorno:

  • total: Total
  • Outras informações relacionadas à empresa

2. building_bigdata_office_address_details

Função: Consulta de detalhes de endereços comerciais de empresas

Com base em informações específicas de identificação da empresa, consulta e retorna dados relacionados aos endereços comerciais da empresa, incluindo o número total de endereços comerciais, informações detalhadas de endereços comerciais por cidade, etc.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - Nome da empresa/número de registro/código de crédito social unificado/ID da empresa
  • address (opcional): Região - Suporta filtro por província/município, exemplo de entrada: "广东省,广州市"
  • pageIndex (opcional): Posição inicial da paginação
  • keywordType (opcional): Tipo de entidade - name: nome da empresa, nameId: ID da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado
  • pageSize (opcional): Posição final da paginação - Máximo de 10 registros por página

Valores de retorno:

  • total: Total
  • resultList: Resultados da lista
    • officeAddress: Endereço
    • officeSourceType: Fonte do endereço
    • officeSettleType: Tipo de ocupação - Registro comercial, endereço comercial
    • estateName: Edifício onde está localizado
    • estateId: ID do edifício

3. building_bigdata_office_address_stats

Função: Análise estatística de endereços comerciais de empresas

Com base em informações específicas de identificação da empresa, consulta e retorna dados relacionados aos endereços comerciais da empresa, incluindo cidades dos endereços comerciais, quantidade de endereços comerciais por cidade, etc.

Parâmetros:

  • matchKeyword (obrigatório): Palavra-chave de correspondência - Nome da empresa/número de registro/código de crédito social unificado/ID da empresa
  • keywordType (opcional): Tipo de entidade - name: nome da empresa, nameId: ID da empresa, regNumber: número de registro, socialCreditCode: código de crédito social unificado

Valores de retorno:

  • officeCityStats: Estatísticas de distribuição de endereços comerciais
    • city: Cidade do endereço comercial
    • count: Quantidade de endereços comerciais

4. building_bigdata_building_query

Função: Consulta de informações de edifícios

Suporta consulta de todas as informações de edifícios em uma região específica por nome do edifício, tipo de edifício, etc., incluindo nome do edifício, alias do edifício, endereço do edifício, tipo de edifício, número de empresas instaladas no edifício, etc.

Parâmetros:

  • matchKeyword (opcional): Palavra-chave de consulta - Consulta edifícios cujo nome/alias contenha a palavra-chave
  • pageIndex (opcional): Posição inicial da paginação
  • address (opcional): Região - Suporta filtro por província/município, exemplo de entrada: "广东省,广州市"
  • pageSize (opcional): Posição final da paginação - Máximo de 10 registros por página
  • estatePropertyType (opcional): Tipo de edifício - Escritório, parque industrial, complexo, apartamento/hotel, centro de exposições

Valores de retorno:

  • total: Total
    • estateName: Nome do edifício
    • estateId: ID do edifício
    • estateAliasName: Alias do edifício
    • estateAddress: Endereço do edifício
    • estatePropertyType: Tipo de edifício
    • estateEnterpriseCount: Número de empresas instaladas no edifício

Cenários de Uso

  1. Gestão interna de empresas: Compreender a distribuição de endereços comerciais e a localização de edifícios
  2. Análise comercial: Realizar análise de distribuição geográfica de mercado
  3. Órgãos governamentais: Verificação de informações de empresas ou apoio à tomada de decisão
  4. Setor imobiliário: Análise da ocupação de edifícios
  5. Parcerias comerciais: Localizar a distribuição de empresas em regiões específicas
  6. Pesquisa de mercado: Análise da atividade comercial regional

Observações de Uso

  1. Exigência de nome completo da empresa: Ao chamar interfaces que exigem o nome completo da empresa, se não houver o nome completo, primeiro chame a interface building_bigdata_fuzzy_search para obter o nome completo
  2. Limite de paginação: A consulta de endereços comerciais retorna no máximo 10 registros por página; a pesquisa de empresas retorna no máximo 50 registros por página
  3. Filtro por região: Suporta filtro por província e município, no formato "província,município"
  4. Tipo de edifício: Suporta filtro por tipos como escritório, parque industrial, complexo, etc.

Exemplos de Perguntas

building_bigdata_fuzzy_search (Pesquisa difusa por palavras-chave de empresas)

  1. Ajude-me a encontrar informações de empresas que contenham a palavra-chave "腾讯"
  2. Pesquise a lista de empresas relacionadas a "阿里"
  3. Consulte empresas cujo nome contenha "抖音"

building_bigdata_office_address_details (Consulta de detalhes de endereços comerciais de empresas)

  1. Consulte os detalhes dos endereços comerciais da Tencent Technology Co., Ltd.
  2. Quais endereços comerciais o Alibaba Group possui em Pequim?
  3. Informações de endereços comerciais da ByteDance em Xangai

building_bigdata_office_address_stats (Análise estatística de endereços comerciais de empresas)

  1. Estatísticas da distribuição de endereços comerciais da Tencent em várias cidades do país
  2. Distribuição por cidade dos endereços comerciais do Alibaba
  3. Estatísticas da quantidade de endereços comerciais da Huawei em várias cidades

building_bigdata_building_query (Consulta de informações de edifícios)

  1. Consulte informações de escritórios no distrito de Nanshan, Shenzhen
  2. Pesquise edifícios de parques industriais em Zhongguancun, Pequim
  3. Encontre informações de edifícios de complexos no distrito de Pudong, Xangai