customs-mcp-server

handaas/customs-mcp-server

3.2

If you are the rightful owner of customs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP service provides comprehensive import and export trade data query functions, including export trend analysis, product category statistics, order geographic distribution, and overseas certification information, helping users understand the international trade situation of enterprises.

The customs-mcp-server is a powerful tool designed to facilitate the analysis and understanding of international trade data. It offers a wide range of functionalities that allow users to perform in-depth analyses of export trends, product distributions, and recruitment profiles related to foreign trade. The server is built on Python 3.10+ and requires specific dependencies such as python-dotenv, requests, and mcp. Users can quickly set up the server locally by cloning the project, creating a virtual environment, and configuring necessary environment variables. The server supports multiple startup methods, including stdio, sse, and streamable-http, providing flexibility in deployment. Additionally, it integrates seamlessly with platforms like Cursor and Cherry Studio, allowing for efficient data processing and analysis. The service is particularly useful for businesses looking to analyze their international trade performance, understand market trends, and evaluate competitive positions.

Features

  • Enterprise keyword fuzzy search
  • Export trend analysis
  • Export product analysis
  • Order geographic distribution
  • Overseas certification query

Usages

usage with cursor cherry studio streamable http

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

usage with cursor cherry studio stdio

{
  "mcpServers": {
    "customs-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

usage with official remote service

{
  "mcpServers": {
    "customs-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/customs/customs_bigdata?token={token}"
    }
  }
}

Tools

  1. customs_bigdata_fuzzy_search

    Enterprise keyword fuzzy query

  2. customs_bigdata_export_trends

    Export trend analysis

  3. customs_bigdata_export_product_trends

    Export product trend analysis

  4. customs_bigdata_export_recruitment_profile

    Foreign trade recruitment analysis

  5. customs_bigdata_export_order_regions

    Export order geographic distribution

  6. customs_bigdata_overseas_certifications

    Overseas certification information query