无障碍设施MCP服务使用指南
概述
本MCP（Model Context Protocol）服务提供无障碍设施数据查询能力，支持智能客服、旅游App、城市治理等场景。通过标准化的MCP协议，为LLM/Agent提供可调用的工具，实现无障碍设施查询、统计分析和推荐功能。
服务特性
- 统一鉴权: 支持API Key认证，提供配额控制和使用统计
- 多协议支持: 基于HTTP/SSE传输，兼容MCP标准协议
- 数据丰富: 涵盖景点、酒店、餐饮等各类场所的无障碍设施信息
- 智能筛选: 支持按城市、设施类型、无障碍特征等多维度筛选
- 实时响应: 优化的数据库查询，确保快速响应
快速开始
1. 获取API密钥
- 访问服务管理后台
- 进入"API密钥管理"页面
- 创建新的API密钥
- 保存密钥，后续调用时需要使用
2. 服务地址
HTTP端点: http://www.mayijf.com/sse3. 认证方式
支持以下三种认证方式（按优先级排序）：
- Authorization Header（推荐）
Authorization: Bearer YOUR_API_KEY- X-API-Key Header
X-API-Key: YOUR_API_KEY- 查询参数
?key=YOUR_API_KEY工具列表
search_accessible_attractions - 搜索无障碍景点
根据城市名称搜索具备无障碍设施的景点，支持按无障碍特征筛选。
参数说明：
city(string, 必填): 城市名称，如"杭州"、"北京市"has_accessible_ramp(bool, 可选): 是否需要无障碍坡道has_accessible_toilet(bool, 可选): 是否需要无障碍厕所has_elevator(bool, 可选): 是否需要电梯has_accessible_boat(bool, 可选): 是否需要无障碍船只has_accessible_tour(bool, 可选): 是否需要无障碍观光车limit(int, 可选): 返回结果数量限制，默认10，最大50
返回格式：
{
"success": true,
"count": 2,
"data": [
{
"name": "西湖风景区",
"city": "杭州",
"province": "浙江",
"district": "西湖区",
"category": "景点",
"latitude": 30.2500,
"longitude": 120.1667,
"accessibilityFeatures": {
"hasRamp": true,
"hasAccessibleToilet": true,
"hasElevator": false,
"hasAccessibleBoat": true,
"hasAccessibleTour": true
},
"images": ["image1.jpg", "image2.jpg"]
}
]
}search_accessible_hotels - 搜索无障碍酒店
搜索具备无障碍设施的酒店信息。
参数说明：
city(string, 必填): 城市名称has_accessible_ramp(bool, 可选): 是否需要无障碍坡道has_accessible_toilet(bool, 可选): 是否需要无障碍厕所has_elevator(bool, 可选): 是否需要电梯limit(int, 可选): 返回结果数量限制，默认10，最大50
返回格式： 与景点搜索类似，返回符合条件的酒店列表。
search_accessible_transport - 搜索无障碍交通
搜索城市的无障碍交通信息。
参数说明：
city(string, 必填): 城市名称transport_type(string, 可选): 交通类型，如"地铁"、"公交"、"出租车"accessibility_feature(string, 可选): 无障碍特征，如"轮椅坡道"、"盲道"、"语音报站"limit(int, 可选): 返回结果数量限制，默认10，最大50
返回格式：
{
"success": true,
"count": 3,
"data": [
{
"transportType": "地铁",
"line": "1号线",
"station": "龙翔桥站",
"accessibilityFeatures": ["轮椅坡道", "盲道", "语音报站"],
"description": "站内设有无障碍电梯和专用通道"
}
]
}MCP客户端配置
在MCP客户端配置文件中添加：
{
"mcp": {
"servers": {
"accessibility_service": {
"description": "无障碍设施MCP服务",
"type": "sse",
"url": "http://www.mayijf.com/sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}
常见错误码：
- `401`: API密钥无效或已过期
- `403`: API密钥使用次数超限
- `400`: 请求参数错误
- `500`: 服务器内部错误
## 使用限制
- 单次请求返回结果最多50条
- API密钥有日调用次数限制
- 支持并发请求，但有频率限制
- 建议使用连接池复用连接
## 适用场景
### 智能客服/导览机器人
回答用户关于"本市有哪些无障碍设施"、"某景区是否有无障碍厕所/坡道"等问题。
### 旅游与出行App
在目的地、景点、酒店详情页动态显示无障碍友好程度，帮助用户做出出行决策。
### 城市治理与公共服务
获取城市维度的无障碍统计数据，辅助专题分析和政策制定。
### 无障碍咨询与合规
快速评估特定区域的设施覆盖情况，辅助报告撰写和合规检查。