Factory Insight

You can access factory insights data through an MCP server that provides production capacity analysis for manufacturing enterprises. It helps you search for factories, view profiles, analyze product stats, and assess capabilities, enabling informed supplier selection, investment decisions, and risk assessment.

How to use

You connect an MCP client to the server to query factory information and analysis results. Start by configuring one or more MCP connections (HTTP to a remote endpoint or a local stdio process). Use focused queries to look up factories by name, main products, location, or other keywords, then drill into factory profiles, product statistics, and capability assessments. You can combine search criteria to filter results and paginate through large result sets.

How to install

Prerequisites: Python 3.10 or newer, and a working environment with access to install Python packages.

git clone https://github.com/handaas/factory-insight-mcp-server
cd factory-insight-mcp-server

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

Additional sections

Environment configuration and runtime options are shown in the following configuration examples. You can run the MCP server locally via a streamable HTTP endpoint or as a stdio process, and you can connect via Cursor / Cherry Studio MCP configuration.

{
  "mcpServers": {
    "handaas_mcp_server": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp",
      "args": []
    }
  }
}

To run the server locally using a stdio approach, you can execute the following runtime command with the environment variables shown. This starts the MCP server by running the Python script via the uv wrapper.

{
  "mcpServers": {
    "factory_insight": {
      "type": "stdio",
      "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"
      }
    }
  }
}

Notes on usage and configuration

Securely manage access by keeping your integrator credentials secret. When you validate factory data, distinguish design capacity from actual capacity and verify equipment information through on-site checks when possible. Region-based searches require a specific format for multiple locations.

The available tools allow fuzzy searching for enterprises, querying factory profiles, obtaining product statistics, evaluating production capabilities, filtering factories by criteria, and analyzing factory geographic distribution.

Example usage questions you can ask your MCP client include:

• What is the factory profile for a given company, including risk assessments and capital?
• How many service brands are associated with a factory and what are the main products?
• Which factories match a set of keywords in a given region and industry?

Available tools

factory_insight_fuzzy_search

Fuzzy search for enterprise keywords across names, brands, products, and roles to find matching factories.

factory_insight_factory_profile

Query factory profile information for a given enterprise, including risk assessments and factory details.

factory_insight_factory_product_stats

Retrieve product statistics for a factory, including service brands, main products, and product categories.

factory_insight_factory_capabilities

Evaluate factory production capabilities, including lines, devices, and certifications.

factory_insight_factory_search

Filter and search factories by name, products, and location with pagination.