Guoguo

You can run and interact with the Guoguo MCP Server to manage mailing addresses, create and track shipping orders, and perform advanced queries. It supports HTTP integration with remote shipping providers as well as mock mode for development and testing, making it easy to simulate real-world scenarios or connect to an actual service.

How to use

Use an MCP client to connect to the Guoguo MCP Server and perform common shipping operations. You can either connect to a remote API endpoint or run the server locally via a command-line client. In production, point the client at your real Shipping API and disable mock mode. In development, enable mock mode to work with simulated data and flows.

How to install

Prerequisites you need before installing: Python is installed and available on your system. You may also use uvx to run MCP servers without a separate Python installation.

# Install via uvx (recommended for quick start)
uvx guoguo-mcp-server --help

# If you need to specify a package index
uvx --index-url https://pypi.org/simple/ guoguo-mcp-server --help

# Install with pip
pip install guoguo-mcp-server

Additional sections

Configuration options let you point the server at a real API or run with mock data. You can supply API base URLs and tokens via command-line arguments or environment variables. The server exposes an HTTP interface for real integration and supports a mock mode for development and testing.

Environment variables you may use include SHIPPING_API_BASE_URL, SHIPPING_API_TOKEN, and SHIPPING_USE_MOCK. These let you configure the server without editing command strings.

Typical start flows include: run the server against a real API with mock disabled, or start in mock mode for development. When you are ready, switch to production by pointing to your production API and supplying the production token.

Available tools

query_address_book

Query the user’s address book with an optional keyword to search by name, phone, or address.

create_shipping_order

Create a new shipping order with sender/receiver details, package info, and service type.

list_shipping_orders

Paginated listing of shipping orders with optional date range and status filters.

get_order_detail

Retrieve detailed information for a specific order, including tracking history.