800bus-mcp

800BUS（800bus.cn）公交图片档案站的 MCP 服务，把站点只读开放接口（/api/v1，12 个 GET 端点）封装成 AI 可直接调用的工具。

• 全部接口只读、匿名、无副作用：不会写入数据、不会发通知、不会改动任何状态
• 默认 60 次/分钟/IP 限流，超限时工具会返回 rate_limited 提示
• 不返回邮箱、精确拍摄地点、审核人等隐私字段；匿名评论统一显示为「匿名用户」
• 图片与数据遵循 CC BY-NC-ND 4.0：非商业用途、署名 800BUS、禁止演绎，禁止用于模型训练或批量镜像

安装

pip install 800bus-mcp
# 或免安装直接运行
uvx 800bus-mcp

要求 Python ≥ 3.10。

配置

Claude Desktop

编辑 claude_desktop_config.json（macOS/Linux：~/Library/Application Support/Claude/；Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "800bus": {
      "command": "uvx",
      "args": ["800bus-mcp"]
    }
  }
}

已用 pip 安装时也可以写成：

{
  "mcpServers": {
    "800bus": {
      "command": "800bus-mcp"
    }
  }
}

Cursor

在 ~/.cursor/mcp.json（项目级为 .cursor/mcp.json）中加入：

{
  "mcpServers": {
    "800bus": {
      "command": "uvx",
      "args": ["800bus-mcp"]
    }
  }
}

其他 MCP 客户端

本服务使用 stdio 传输，启动命令 800bus-mcp（或 python -m bus800_mcp）即可。

环境变量

可用工具

工具返回值为紧凑 JSON 文本，结构与开放接口的 success / data / meta 信封一致。

使用示例

配置好之后，可以直接对 AI 说：

• 「查一下 800BUS 现在有多少张档案、今日新增多少」
• 「搜索南昌的宇通客车档案，按评分排序，给我前 5 张」
• 「看看档案 14222 的详情和评论」
• 「读完最新的资讯，再列出江西省有哪些城市和公司」
• 「取南昌附近地图上的档案标记，按分区筛选」

建议 AI 先调用 get_meta 拿到合法的分区 key 与排序枚举，再用 list_photos 检索，避免参数非法。

自检与版本

800bus-mcp --version   # 打印版本
800bus-mcp --selftest  # 请求 /api/v1/stats，验证网络与接口连通性

相关链接

• 开放平台说明：https://800bus.cn/openapi/
• 接口文档（OpenAPI 3.1）：https://800bus.cn/yszc/openapi.html
• 问题反馈：站内工单 https://800bus.cn/ticket.php

许可证

本包代码使用 MIT 许可证，详见 LICENSE。通过本包获取的站点数据与图片遵循 CC BY-NC-ND 4.0。