这是一个基于Model Context Protocol (MCP) 实现的服务器，用于连接您的AI助手（如Claude或Cursor）与Shiprocket物流管理平台。通过这个服务器，您的AI助手可以直接访问和管理Shiprocket账户中的物流信息。

项目简介

该项目是 Shiprocket 物流管理平台的一个 MCP 服务器实现。它允许通过 MCP 协议暴露 Shiprocket 的功能，使得支持 MCP 的 LLM 客户端可以直接调用这些功能，而无需用户手动操作 Shiprocket 网页或应用。

主要功能点

• 查询物流信息： 获取特定地点的预计送达日期。
• 计算运费： 根据取件地、派送地、包裹重量和支付方式，查询可用的快递公司、运费和预计送达时间。
• 追踪订单： 通过订单号、AWB 号或渠道订单号查询订单的当前状态和物流详情。
• 订单管理：
  • 创建新订单。
  • 为订单分配快递公司并生成 AWB 号（发货）。
  • 安排已发货订单的取件。
  • 取消订单。
  • 列出账户中已配置的取件地址。

安装步骤

1. 克隆仓库： 从 GitHub 克隆该仓库到本地。

   git clone https://github.com/bfrs/shiprocket-mcp.git
   cd shiprocket-mcp
   

2. 安装依赖并构建： 使用 npm 安装项目所需的库，并构建可执行文件。

   npm install
   npm run build
   

服务器配置

将以下配置信息添加到您的 LLM 客户端的 MCP 配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json' 或 Cursor 的 'mcp.json'）。

• 名称 (server name): 'shiprocket' (这是在客户端中识别该服务器的名称)
• 启动命令 (command): 'npm' (执行 npm 命令来启动服务器)
• 命令参数 (args):
  • '--prefix'：指定项目根目录路径。请将 '{{PATH_TO_SRC}}' 替换为您实际克隆仓库的本地路径。
  • 'start'：执行 'package.json' 中定义的启动脚本。
  • '--silent'：静默启动，减少控制台输出。
• 环境变量 (env):
  • 'SELLER_EMAIL': 您的 Shiprocket 卖家账户登录邮箱。
  • 'SELLER_PASSWORD': 您的 Shiprocket 卖家账户登录密码。

请注意： 上述信息需要按照您使用的 MCP 客户端的要求，以特定的 JSON 格式进行配置。请参考您的 LLM 客户端关于配置 MCP 服务器的文档。不要直接复制上面的代码片段到配置文件中。

基本使用方法

1. 完成上述安装和配置步骤。
2. 启动或重启您的 LLM 客户端（如 Claude Desktop 或 Cursor）。
3. 客户端应该会识别出“Shiprocket”集成。
4. 现在您可以直接通过与 AI 助手对话来使用 Shiprocket 的功能，例如：
   • “查询从德里到班加罗尔最快的快递公司。”
   • “追踪我的订单 [提供订单号或 AWB 号]。”
   • “帮我创建一个新订单，收件人 [姓名] 到地址 [地址详情]，包含 [商品名称] 等物品。”
   • “计算从 [取件地邮编] 到 [派送地邮编] 的 [重量] 公斤包裹的运费。”

LLM 客户端会理解您的请求并调用对应的 Shiprocket MCP 工具来执行操作。