modelscope·@jlwainwright/shiplogic-mcp
暂无描述。
这是一个模型上下文协议(MCP)服务器,提供与Shiplogic运输API的无缝集成。使用MCP SDK和TypeScript构建,以确保类型安全并提升开发体验。
bash
用户: "查询从开普敦到约翰内斯堡2.5公斤包裹的运费" Claude: "我将为您查询运费..."
[使用工具: get_shipping_rates] 结果: 经济服务 - R95 (2-3天送达)
用户: "预订经济服务" Claude: "正在创建发货单..."
[使用工具: create_shipment] 结果: 发货单已创建!追踪号: QR4FVL
克隆并安装: bash git clone https://github.com/jlwainwright/shiplogic-mcp.git cd shiplogic-mcp npm install
配置环境变量: bash cp .env.example .env
构建服务器: bash npm run build
将以下内容添加到您的Claude桌面配置中:
json { "mcpServers": { "shiplogic": { "command": "node", "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"], "env": { "SHIPLOGIC_API_KEY": "your_api_key_here" } } } }
使用MCP Inspector测试服务器:
bash npm run inspect
直接运行服务器:
bash npm run dev
get_shipping_rates计算两个地址之间的运费。
typescript { 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创建带有跟踪的新发货单。
typescript { service_level_code: string, // 例如:"ECO" collection_address: { /* 同上 / }, delivery_address: { / 同上 / }, parcels: [{ / 同上 */ }], 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通过参考编号追踪发货单。
typescript { tracking_number: string }
cancel_shipment取消现有的发货单。
typescript { tracking_reference: string }
get_opt_in_rates获取可选附加服务的费率。
typescript { collection_address: { /* 地址对象 / }, delivery_address: { / 地址对象 */ } }
add_address_to_book向账户地址簿中添加一个地址。
typescript
{
account_id: number,
address: {
street_address: string,
city: string,
code: string,
country?: string,
type?: "residential" | "business",
company?: string
},
name?: string, // 此地址条目的名称
type?: "collection" | "delivery" // 地址类型
}### get_address_book
从账户的地址簿中检索地址。
typescript { account_id: number, type?: "collection" | "delivery" // 可选,按类型过滤 }
remove_address_from_book从账户的地址簿中移除一个地址。
typescript { 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 # 主服务器实现 ├── dist/ # 编译后的JavaScript(生成) ├── package.json ├── tsconfig.json ├── .env.example └── README.md
npm run build - 编译TypeScriptnpm run dev - 构建并运行npm run inspect - 使用MCP Inspector运行bash
npm run inspect
curl -X POST http://localhost:3000/tools/list
此服务器与Shiplogic API v2集成。有关详细的API文档,请参阅:
MIT许可证 - 查看LICENSE文件
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)如果您觉得这个项目有帮助,请考虑支持我的工作。您的支持有助于我投入更多时间进行开源开发,并为社区创造更好的工具。
由Jacques Wainwright用❤️制作
一种MCP服务器,它将人工智能助手连接到SearchAgora,使用户能够通过自然语言对话在网页上搜索、发现和购买产品。
一个服务器,它通过BigGo的价格比较API,实现跨多个电子商务平台搜索产品、追踪价格历史以及比较产品规格的功能。
一个概念验证的模型上下文协议服务器,使大型语言模型应用程序能够与Uber Eats互动,允许人工智能代理通过自然语言浏览和订购食物。
使用 Apify 提供的 3,000 多种预构建云工具(称为 Actors),从网站、电子商务平台、社交媒体、搜索引擎、地图等提取数据。
暂无描述。
暂无描述。