MCP 服务器

Building Big Data MCP Server

Provides comprehensive building and office address information queries for enterprises in China, including fuzzy enterprise search, office address details and statistics, and building information queries to support geographical distribution and occupancy analysis.

README

楼宇大数据服务

该MCP服务提供全面的楼宇和办公地址信息查询功能，包括企业办公地址查询、楼宇信息查询等，帮助用户进行地理分布分析和楼宇入驻分析。

主要功能

🔍 企业关键词模糊搜索
🏢 企业办公地址查询
📊 办公地址统计分析
🏗️ 楼宇信息查询

环境要求

Python 3.10+
依赖包：python-dotenv, requests, mcp

本地快速启动

1. 克隆项目

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

2. 创建虚拟环境&安装依赖

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

3. 环境配置

复制环境变量模板并配置：

cp .env.example .env

编辑 .env 文件，配置以下环境变量：

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. streamable-http启动服务

python server/mcp_server.py streamable-http

服务将在 http://localhost:8000 启动。

支持启动方式 stdio 或 sse 或 streamable-http

5. Cursor / Cherry Studio MCP配置

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

STDIO版安装部署

设置Cursor / Cherry Studio MCP配置

{
  "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"
      }
    }
  }
}

使用官方Remote服务

1. 直接设置Cursor / Cherry Studio MCP配置

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

注意：integrator_id、secret_id、secret_key及token需要登录 https://www.handaas.com/ 进行注册开通平台获取

可用工具

1. building_bigdata_fuzzy_search

功能: 企业关键词模糊查询

根据提供的企业名称、人名、品牌、产品、岗位等关键词模糊查询相关企业列表。

参数:

matchKeyword (必需): 匹配关键词 - 查询各类信息包含匹配关键词的企业
pageIndex (可选): 分页开始位置
pageSize (可选): 分页结束位置 - 一页最多获取50条数据

返回值:

total: 总数
其他企业相关信息

2. building_bigdata_office_address_details

功能: 企业办公地址详情查询

根据特定的企业标识信息，查询和返回企业的办公地址相关数据，包括办公地址总数、每个城市的办公地址详细信息等。

参数:

matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
address (可选): 地区 - 支持筛选省/市，输入示例："广东省,广州市"
pageIndex (可选): 分页开始位置
keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码
pageSize (可选): 分页结束位置 - 一页最多获取10条数据

返回值:

total: 总数
resultList: 列表结果
- officeAddress: 地址
- officeSourceType: 地址来源
- officeSettleType: 入驻方式 - 工商注册入驻，办公地址入驻
- estateName: 所在楼宇
- estateId: 楼宇id

3. building_bigdata_office_address_stats

功能: 企业办公地址统计分析

根据特定的企业标识信息，查询和返回企业的办公地址相关数据，包括办公地址城市、每个城市的办公地址数量等。

参数:

matchKeyword (必需): 匹配关键词 - 企业名称/注册号/统一社会信用代码/企业id
keywordType (可选): 主体类型 - name：企业名称，nameId：企业id，regNumber：注册号，socialCreditCode：统一社会信用代码

返回值:

officeCityStats: 办公地址分布统计
- city: 办公城市
- count: 办公地址数量

4. building_bigdata_building_query

功能: 楼宇信息查询

支持通过楼宇名称、楼宇类型等查询指定地区的全部楼盘信息，包括楼宇名称、楼宇别名、楼宇地址、楼宇类型、楼宇入驻企业数量等。

参数:

matchKeyword (可选): 查询关键词 - 查询楼宇名称/楼宇别名包含关键词的楼盘
pageIndex (可选): 分页开始位置
address (可选): 地区 - 支持筛选省/市，输入示例："广东省,广州市"
pageSize (可选): 分页结束位置 - 一页最多获取10条数据
estatePropertyType (可选): 楼宇类型 - 写字楼，产业园，综合体，公寓酒店，展会中心

返回值:

total: 总数
- estateName: 楼宇名称
- estateId: 楼宇id
- estateAliasName: 楼宇别名
- estateAddress: 楼宇地址
- estatePropertyType: 楼宇类型
- estateEnterpriseCount: 楼宇入驻企业数量