MCP-Agent

karen

MCP_API_DOCUMENTATION_v2.md
亲邻传媒 MCP API 完整文档
服务地址: http://47.253.159.62:8888
版本: v2.0 | 更新日期: 2026-08-15
状态: 所有服务正常运行 ✅

目录
快速开始
媒体资源数据类型
工具调用示例
24个工具完整清单
数据库资源统计
Python SDK 使用
返回格式说明
快速开始
健康检查
curl http://47.253.159.62:8888/health
响应:

{"service":"MCP Proxy (8888)","status":"ok","target":"5002","version":"v1.0"}
基础调用格式
curl -X POST http://47.253.159.62:8888/api/v2/mcp/pdooh/tools/call \n  -H "Content-Type: application/json" \n  -d '{
    "name": "工具名称",
    "arguments": {
      "参数1": "值1",
      "参数2": "值2"
    }
  }'
媒体资源数据类型
数据类型        工具名        数据库记录数        说明
广告门(门禁)        pdooh_query_access_points        66,308 个楼盘        社区大门广告位
单元门        pdooh_query_smart_frames        8,114 个楼盘        单元楼入口灯箱
电梯框架        pdooh_query_elevator_frames        5,280 个楼盘        电梯内框架广告
智能屏        pdooh_query_screens        9,801 台        数字屏广告
道闸        pdooh_query_daocha_points        1,021 个点位        停车场道闸广告
LED点位        pdooh_query_led_points        46 个        商场LED广告
梯影/影媒        pdooh_query_shadow_points        -        电梯投影媒体
客户通讯录        pdooh_query_customers        26,767 条        客户联系方式
工具调用示例
1. 查询广告门(门禁)点位
curl -X POST http://47.253.159.62:8888/api/v2/mcp/pdooh/tools/call \n  -H "Content-Type: application/json" \n  -d '{
    "name": "pdooh_query_access_points",
    "arguments": {
      "city": "广州",
      "limit": 10
    }
  }'
参数:

参数        类型        必填        说明
city        string        是        城市名称
district        string        否        区域/区县
limit        number        否        返回数量，默认20
2. 查询单元门点位
curl -X POST http://47.253.159.62:8888/api/v2/mcp/pdooh/tools/call \n  -H "Content-Type: application/json" \n  -d '{
    "name": "pdooh_query_smart_frames",
    "arguments": {
      "city": "广州",
      "limit": 10
    }
  }'
3. 查询电梯框架点位
curl -X POST http://47.253.159.62:8888/api/v2/mcp/pdooh/tools/call \n  -H "Content-Type: application/json" \n  -d '{
    "name": "pdooh_query_elevator_frames",
    "arguments": {
      "city": "广州",
      "limit": 10
    }
  }'
返回字段:

字段        说明
城市/区域/商圈        地理位置
楼盘名称/地址        具体点位
类型        住宅/写字楼/商住两用
单价        楼盘单价(元/㎡)
户数/人口        楼盘规模
电梯内媒体/厅堂媒体/总媒体        媒体数量
4. 查询智能屏