Shiplogic MCP 服务器

模型上下文协议 (MCP) 服务器，可与 Shiplogic 运输 API 无缝集成。它基于 MCP SDK 和 TypeScript 构建，以确保类型安全并提升开发者体验。

演示

# Example conversation with Claude:
User: "Get shipping rates from Cape Town to Johannesburg for a 2.5kg parcel"
Claude: "I'll check shipping rates for you..."

[Using tool: get_shipping_rates]
Result: Economy service - R95 (2-3 days delivery)

User: "Book the economy service"
Claude: "Creating shipment..."

[Using tool: create_shipment]
Result: Shipment created! Tracking: QR4FVL

特征

🚚获取运费- 计算地址之间的运费
📦创建货运- 预订货运并自动跟踪
🔍追踪包裹- 实时追踪货运
❌取消发货- 需要时取消预订
➕可选服务- 获得特殊服务的附加费率
📚地址簿管理- 存储和管理常用地址

安装

先决条件

Node.js 18+
npm 或 yarn
Shiplogic API 密钥（在shiplogic.com获取）

快速入门

克隆并安装：

git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install

配置环境：

cp .env.example .env
# Edit .env and add your Shiplogic API key

构建服务器：

npm run build

用法

使用 Claude Desktop

将其添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "shiplogic": {
      "command": "node",
      "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"],
      "env": {
        "SHIPLOGIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用 MCP 检查器

使用 MCP 检查器测试服务器：

npm run inspect

独立

直接运行服务器：

npm run dev

可用工具

`get_shipping_rates`

计算两个地址之间的运费。

{
  collection_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  delivery_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  parcels: [{
    length: number,    // cm
    width: number,     // cm
    height: number,    // cm
    weight: number,    // kg
    description?: string
  }],
  declared_value?: number
}

`create_shipment`

创建带有追踪功能的新货件。

{
  service_level_code: string,  // e.g., "ECO"
  collection_address: { /* same as above */ },
  delivery_address: { /* same as above */ },
  parcels: [{ /* same as above */ }],
  collection_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  delivery_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  customer_reference?: string,
  mute_notifications?: boolean
}

`track_shipment`

通过参考编号追踪货件。

{
  tracking_number: string
}

`cancel_shipment`

取消现有的发货。

{
  tracking_reference: string
}

`get_opt_in_rates`

获取可选的附加服务费率。

{
  collection_address: { /* address object */ },
  delivery_address: { /* address object */ }
}

`add_address_to_book`

将地址添加到帐户的地址簿。

{
  account_id: number,
  address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business",
    company?: string
  },
  name?: string,            // Name for this address entry
  type?: "collection" | "delivery"  // Address type
}

`get_address_book`

从帐户的地址簿中检索地址。

{
  account_id: number,
  type?: "collection" | "delivery"  // Optional filter by type
}

`remove_address_from_book`

从帐户的地址簿中删除一个地址。

{
  account_id: number,
  address_id: number
}

配置

环境变量：

多变的	描述	必需的	默认
`SHIPLOGIC_API_KEY`	您的 Shiplogic API 密钥	是的	-
`SHIPLOGIC_API_URL`	API 基本 URL	不	`https://api.shiplogic.com`

发展

项目结构

shiplogic-mcp-official/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

脚本

npm run build编译 TypeScript
npm run dev - 构建并运行
npm run inspect - 使用 MCP Inspector 运行

测试

# Run with MCP Inspector
npm run inspect

# In another terminal, test the tools
curl -X POST http://localhost:3000/tools/list

API 参考

此服务器集成了 Shiplogic API v2。有关详细的 API 文档，请参阅：

执照

MIT 许可证 - 请参阅LICENSE文件

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交更改（ git commit -m 'Add amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

支持

🐛 问题： GitHub 问题
📧 电子邮件： your.email@example.com
📚 文档： Wiki
☕ 支持我的工作：请我喝杯咖啡

如果您觉得这个项目有帮助，请考虑支持我的工作。您的支持可以帮助我投入更多时间进行开源开发，并为社区创造更好的工具。

致谢

使用模型上下文协议 SDK构建
由Shiplogic API提供支持

由 Jacques Wainwright 用❤️制作

Shiplogic MCP Server

Integrations

Shiplogic MCP 服务器

演示

特征

安装

先决条件

快速入门

用法

使用 Claude Desktop

使用 MCP 检查器

独立

可用工具

`get_shipping_rates`

`create_shipment`

`track_shipment`

`cancel_shipment`

`get_opt_in_rates`

`add_address_to_book`

`get_address_book`

`remove_address_from_book`

配置

发展

项目结构

脚本

测试

API 参考

执照

贡献

支持

致谢

Tools

Related Resources

Related MCP Servers

Autumn MCP Server

Unstructured API MCP Serverofficial

ShipStation API MCP Server

ShipHero MCP Server

New MCP Servers