BinaSmart

BinaSmart MCP 服务

面向 BinaSmart（bina.et）的公开 Model Context Protocol 服务，这是埃塞俄比亚的一体化平台。任何支持 MCP 的助手（Claude、ChatGPT、Gemini 等）都可以使用它来：

• 在亚的斯亚贝巴叫车：查询固定车费、预订行程（须先由用户确认）、查看行程状态、取消行程
• 查找地点：建筑、酒店、医院和诊所、商店和餐厅，以及对应的 bina.et 页面
• 工作和招标：按领域或城市查询公开职位（阿姆哈拉语或英语）、雇主和有截止日期的公开招标。支持 MCP Apps 的助手会以职位卡片形式展示招聘信息
• 在海外工作：获得许可的埃塞俄比亚海外就业中介及其海湾合作委员会（GCC）合作办公室
• 房屋和汽车：出售或出租的房产、待售汽车
• 指南和新闻：双语版 Digital Ethiopia 指南（Fayda、护照、telebirr、税务等）和阿姆哈拉语新闻
• BinaPool：共享通勤路线和群组

端点： https://bina.et/mcp（Streamable HTTP，无状态，无需登录） 注册表： MCP Registry 上的 et.bina/binasmart 文档： GET https://bina.et/mcp · 健康检查：https://bina.et/mcp/health

Claude 插件

plugin/ 文件夹是一个 Claude 插件：包含同一个 MCP 服务，以及五个教 Claude 如何将其用于叫车、求职、办理文书、查找地点和招标的技能。它不包含代码，只有 Markdown 技能和一个 MCP 服务条目。

连接

在任何接受远程 MCP 服务的客户端中，添加 URL https://bina.et/mcp。例如，在 Claude 中：设置 → 连接器 → 添加自定义连接器。

构建方式

• mcp-server/server.mjs：MCP 端点（Express + @modelcontextprotocol/sdk）
• mcp-server/tools/：每类工具对应一个文件（ride、directory、jobs、health、market、content、guides、knowledge、agencies）
• mcp-server/widgets/ 和 mcp-server/lib/widgets.mjs：职位卡片页面（MCP Apps），以 ui://bina/jobs-v1.html 提供服务，并内嵌 @modelcontextprotocol/ext-apps 浏览器包
• mcp-server/lib/：电话号码规范化、幂等键（确保重试不会重复预订）、每位调用者的速率限制器、行程 API 客户端
• api/ 和 hotels/rules.js：来自 BinaSmart 主应用的共享用量计量器、API 密钥检查和酒店规则；本服务会导入这些内容

服务与私有的 BinaSmart 应用并行运行，并在运行时读取其数据和设置（数据库、本地主机上的行程 API、.env 文件）。**此代码库中不包含任何凭据。**因此，这段代码准确记录了公开端点的行为，但单独运行时无法使用 BinaSmart 数据。

安全

• request_ride 和 cancel_ride 标记为写入工具（readOnlyHint: false），因此客户端会在调用前征求用户同意。
• 职位卡片页面只读取工具结果：它通过宿主打开 bina.et 链接，且无法访问其他网站。
• 审核人员可以使用预留号码 0900000099 测试 request_ride：它会返回明确标记的测试预订，且不会派遣司机。
• 每个电话号码每 10 分钟最多可预订 5 次，每位调用者每小时最多可预订 10 次。10 分钟内使用相同详情重试时，会返回同一笔预订，而不会创建第二笔。
• 行程仅接受埃塞俄比亚电话号码。日志中的电话号码会经过掩码处理。
• 隐私：bina.et/privacy · 条款：bina.et/terms · 支持：bina.et/support

独立运行（仅工具定义）

node mcp-server/stdio.mjs 可通过 stdio 启动相同的工具，无需 BinaSmart 数据库或 .env，因此 Glama 等 MCP 目录可以在自己的容器中构建它并读取工具定义。需要实时数据的调用会返回错误，并指向 https://bina.et/mcp。

测试

cd mcp-server && npm install && node --test test/*.test.mjs

测试仅使用预留的测试电话号码。

许可证

MIT。请参阅 LICENSE。© 2026 BinaSmart（Ibrahim Kedir）。