freight-mcp
Real-time ocean freight rates, LCL pricing, and booking management for global logistics.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"freight-mcp": {
"url": "https://search.shaq-logistics.com/sse"
}
}
}远程端点
https://search.shaq-logistics.com/ssesse它能做什么
工具清单
工具（13）
🟢search_freight_rates(origin, destination, container_type)
Search real-time ocean freight rates (FCL & LCL) between two ports. Returns available rates with price and validity. Port names support aliases (e.g. 'Shenzhen' matches all Shenzhen terminals, 'LA' matches 'Los Angeles'). Example: search_freight_rates(origin='Shenzhen', destination='Los Angeles', container_type='40HC')
输入模式
{
"type": "object",
"properties": {
"origin": {
"title": "Origin",
"type": "string"
},
"destination": {
"title": "Destination",
"type": "string"
},
"container_type": {
"default": "",
"title": "Container Type",
"type": "string"
}
},
"required": [
"origin",
"destination"
],
"title": "search_freight_ratesArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_freight_ratesOutput"
}🔴create_booking(pin, origin_port, destination_port, contact_name, contact_phone, ...)
Submit a shipping booking request (FCL or LCL). REQUIRES pin parameter (contact SHAQ at [email protected] to get your pin). REQUIRES 7 mandatory fields: contact_name, contact_phone, contact_email, supplier_name, supplier_phone, supplier_email, po_number. If any mandatory field is missing, the tool returns an error listing which fields are needed. All bookings are created with 'pending_review' status. Example: create_booking(pin='shaq2026', origin_port='Shenzhen', destination_port='Los Angeles', container_type='40HC', container_count=1, contact_name='John', contact_email='[email protected]', contact_phone='+1234567890', supplier_name='ABC Factory', supplier_phone='+8613800001111', supplier_email='[email protected]', po_number='PO-2026-0001', product_name='Electronics')
输入模式
{
"type": "object",
"properties": {
"pin": {
"title": "Pin",
"type": "string"
},
"origin_port": {
"title": "Origin Port",
"type": "string"
},
"destination_port": {
"title": "Destination Port",
"type": "string"
},
"contact_name": {
"title": "Contact Name",
"type": "string"
},
"contact_phone": {
"title": "Contact Phone",
"type": "string"
},
"contact_email": {
"title": "Contact Email",
"type": "string"
},
"supplier_name": {
"title": "Supplier Name",
"type": "string"
},
"supplier_phone": {
"title": "Supplier Phone",
"type": "string"
},
"supplier_email": {
"title": "Supplier Email",
"type": "string"
},
"po_number": {
"title": "Po Number",
"type": "string"
},
"container_type": {
"default": "40GP",
"title": "Container Type",
"type": "string"
},
"container_count": {
"default": 1,
"title": "Container Count",
"type": "integer"
},
"weight_per_container": {
"default": "",
"title": "Weight Per Container",
"type": "string"
},
"product_name": {
"default": "",
"title": "Product Name",
"type": "string"
},
"hs_code": {
"default": "",
"title": "Hs Code",
"type": "string"
},
"service_type": {
"default": "FCL",
"title": "Service Type",
"type": "string"
},
"freight_rate_usd": {
"default": 0,
"title": "Freight Rate Usd",
"type": "number"
},
"remark": {
"default": "",
"title": "Remark",
"type": "string"
}
},
"required": [
"pin",
"origin_port",
"destination_port",
"contact_name",
"contact_phone",
"contact_email",
"supplier_name",
"supplier_phone",
"supplier_email",
"po_number"
],
"title": "create_bookingArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "create_bookingOutput"
}🟢track_booking(order_number)
Track a shipping booking order by order number. Returns current status (pending_review, confirmed, shipped, etc.), timeline, and booking details. Example: track_booking(order_number='SQ-2026-001')
输入模式
{
"type": "object",
"properties": {
"order_number": {
"title": "Order Number",
"type": "string"
}
},
"required": [
"order_number"
],
"title": "track_bookingArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "track_bookingOutput"
}🟢list_ports(query, limit)
List available ports with alias support. Search by name, code, or country. Returns matching ports and their aliases. Example: list_ports(query='China', limit=20) or list_ports(query='Los Angeles')
输入模式
{
"type": "object",
"properties": {
"query": {
"default": "",
"title": "Query",
"type": "string"
},
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
}
},
"title": "list_portsArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "list_portsOutput"
}🟢get_freight_index(route)
Get freight rate index data for market trends. Shows average rates for major trade lanes (e.g. China-US West Coast, China-Europe). Example: get_freight_index(route='china-us-west-coast')
输入模式
{
"type": "object",
"properties": {
"route": {
"default": "",
"title": "Route",
"type": "string"
}
},
"title": "get_freight_indexArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_freight_indexOutput"
}🔴subscribe_rate_alert(email, origin, destination, service_type)
Subscribe to freight rate change alerts. Get notified by email when rates change for a specific route. Example: subscribe_rate_alert(email='[email protected]', origin='Shenzhen', destination='Los Angeles')
输入模式
{
"type": "object",
"properties": {
"email": {
"title": "Email",
"type": "string"
},
"origin": {
"title": "Origin",
"type": "string"
},
"destination": {
"title": "Destination",
"type": "string"
},
"service_type": {
"default": "FCL",
"title": "Service Type",
"type": "string"
}
},
"required": [
"email",
"origin",
"destination"
],
"title": "subscribe_rate_alertArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "subscribe_rate_alertOutput"
}🟢get_sailing_schedule(origin, destination, limit)
Get upcoming vessel sailing schedules between two ports. Returns vessel name, voyage number, ETD, ETA, transit time, and frequency. Use this when customers ask 'when is the next ship' or 'how long does it take'. Example: get_sailing_schedule(origin='Shenzhen', destination='Los Angeles')
输入模式
{
"type": "object",
"properties": {
"origin": {
"title": "Origin",
"type": "string"
},
"destination": {
"title": "Destination",
"type": "string"
},
"limit": {
"default": 5,
"title": "Limit",
"type": "integer"
}
},
"required": [
"origin",
"destination"
],
"title": "get_sailing_scheduleArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_sailing_scheduleOutput"
}🟢get_port_fees(port, fee_type)
Get port fee types for a given port. Returns fee categories, not specific amounts. Args: port: Port name (e.g., Shenzhen, Shanghai, Ningbo) fee_type: Optional filter by fee type Returns: List of port fee types and categories
输入模式
{
"type": "object",
"properties": {
"port": {
"title": "Port",
"type": "string"
},
"fee_type": {
"default": "",
"title": "Fee Type",
"type": "string"
}
},
"required": [
"port"
],
"title": "get_port_feesArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_port_feesOutput"
}🟢get_customs_info(country)
Get customs compliance information for importing to a specific country. Returns required documents, special requirements, restricted items, duty/tax rates, and FTA info. Use this when customers ask about customs, documents, import requirements, or duties. Example: get_customs_info(country='Australia')
输入模式
{
"type": "object",
"properties": {
"country": {
"title": "Country",
"type": "string"
}
},
"required": [
"country"
],
"title": "get_customs_infoArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_customs_infoOutput"
}🟢rate_trends(origin, destination, container_type, weeks)
Get freight rate trend for a lane: are prices rising or falling? Compares currently-valid carrier tariff windows with recently-expired windows, plus market indices (SCFI). Use this when the customer asks whether rates are going up or down, or about market direction. Example: rate_trends(origin='Busan', destination='Altamira', weeks=4)
输入模式
{
"type": "object",
"properties": {
"origin": {
"title": "Origin",
"type": "string"
},
"destination": {
"title": "Destination",
"type": "string"
},
"container_type": {
"default": "",
"title": "Container Type",
"type": "string"
},
"weeks": {
"default": 4,
"title": "Weeks",
"type": "integer"
}
},
"required": [
"origin",
"destination"
],
"title": "rate_trendsArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "rate_trendsOutput"
}🟢cheapest_route(origin, country, container_type, limit)
Find the lowest-priced destination ports in a country from one origin, across all carriers. Returns ranked destinations with the cheapest currently-valid rate, carrier and validity. Use this when the customer asks where it is cheapest to ship within a country. Example: cheapest_route(origin='Shenzhen', country='Mexico')
输入模式
{
"type": "object",
"properties": {
"origin": {
"title": "Origin",
"type": "string"
},
"country": {
"title": "Country",
"type": "string"
},
"container_type": {
"default": "",
"title": "Container Type",
"type": "string"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
}
},
"required": [
"origin",
"country"
],
"title": "cheapest_routeArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "cheapest_routeOutput"
}🟢analyst_chat(question)
Ask SHAQ Freight Analyst a natural-language question about ocean freight rates, routes, trends, container types, surcharges, or Incoterms. The analyst retrieves real-time SHAQ data and answers in the same language as the question. Example: analyst_chat(question='Is the rate from Shenzhen to Manzanillo rising or falling for a 40HC?')
输入模式
{
"type": "object",
"properties": {
"question": {
"title": "Question",
"type": "string"
}
},
"required": [
"question"
],
"title": "analyst_chatArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "analyst_chatOutput"
}🟢search_freight_rates_batch(queries)
Search ocean freight rates for MULTIPLE routes in one call. Accepts natural-language queries: 'Shenzhen to Los Angeles 40HC', '盐田到长滩小柜', 'Shanghai to Hamburg reefer'. Understands Chinese jargon: 小柜=20GP, 大柜=40GP, 高柜=40HQ, 冷藏/冻柜=reefer. Returns a compact per-route summary (rate count, container types, lowest rates). Max 10 queries per call.
输入模式
{
"type": "object",
"properties": {
"queries": {
"items": {
"type": "string"
},
"title": "Queries",
"type": "array"
}
},
"required": [
"queries"
],
"title": "search_freight_rates_batchArguments"
}输出模式
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_freight_rates_batchOutput"
}社区
证据