Bizinfo

You can run Bizinfo as an MCP server to expose Bizinfo Open API data via HTTP requests or through a local, self-contained MCP client. This setup lets you search for support projects by region, target, and keywords, or perform natural language queries, all while integrating with other MCP-enabled tools and workflows.

How to use

Choose your preferred access method through an MCP client. You can call the Bizinfo services via a standard HTTP MCP server setup or run it locally as an on-device stdio server that your MCP client can launch. Your client will be able to perform targeted searches and natural language queries against the Bizinfo data and receive structured JSON results with both an items list and a summary.

Key capabilities you can leverage: searching by region, target, and keywords; submitting a JSON search body for the same parameters; performing natural language queries that are parsed and then executed; and a health check to confirm the service is reachable.

How to install

Prerequisites you need installed before starting: Node.js (with npm) for server-side execution and an MCP client runtime for local stdio configuration.

Install the Bizinfo MCP package and start the MCP server as described in the configuration section. If you prefer a quick local check, you can also use the CLI entry point to test searching without starting the HTTP server.

Steps to prepare and run (typical flow): install dependencies, then start the server, and finally use an MCP client to connect to the Bizinfo MCP server.

Configuration and usage notes

Environment variable you may provide to customize behavior: BIZINFO_API_KEY. If you do not supply your own key, a built-in demo key (QP6yn2) is used for demonstration purposes.

The MCP client will read environment variables from the running directory’s .env file or from the system environment to configure the Bizinfo MCP server.

Example MCP configuration

{
  "mcpServers": {
    "bizinfo": {
      "type": "stdio",
      "name": "bizinfo",
      "command": "npx",
      "args": [
        "-y",
        "@kwangdss/bizinfo-mcp@latest",
        "bizinfo-mcp-server"
      ],
      "env": [
        { "name": "BIZINFO_API_KEY", "value": "YOUR_API_KEY" }
      ]
    }
  }
}

Examples of how to use the server

{
  "region": "광주",
  "target": "소상공인",
  "keywords": "AI"
}

Troubleshooting and tips

If you encounter connection issues, verify that your MCP client is launching the Bizinfo MCP server with the correct environment file or environment variables and that the Bizinfo API key (if provided) is valid.

Check that the server is reachable and that endpoints such as search and search-natural respond with JSON containing an items array and a summary field.

Available tools

search

Query Bizinfo data by region, target, keywords using GET /search or POST /search with a JSON body.

searchNatural

Submit a natural language query via POST /search-natural to parse conditions and perform a search.

healthCheck

Check service health via GET /health to ensure the MCP server is responsive.