# China Business MCP Server

A Model Context Protocol (MCP) server that provides Chinese business registration data queries. Allows AI assistants to look up basic company information registered in China.

## Features

- Query Chinese company basic information (registration number, legal representative, registered capital, etc.)
- Return structured data in a format AI can process

## Installation

### Prerequisites
# China Business MCP Server

A Model Context Protocol (MCP) server that provides Chinese business registration data queries. Allows AI assistants to look up basic company information registered in China.

## Features

- Query Chinese company basic information (registration number, legal representative, registered capital, etc.)
- - Return structured data in a format AI can process
  -
  - ## Installation
  -
  - ### Prerequisites
  -
  - - Node.js 18+
    - - A valid API key from a Chinese business data provider (e.g., Tianyancha, Qichacha)
      -
      - ### Setup
      -
      - 1. Clone the repository:
        2. ```bash
           git clone https://github.com/Dnovalab/china-business-mcp.git
           cd china-business-mcp
           ```

           2. Install dependencies:
           3. ```bash
              npm install
              ```

              3. Create a `.env` file:
              4. ```bash
                 cp .env.example .env
                 ```

                 4. Add your API key to `.env`:
                 5. ```
                    API_KEY=your_api_key_here
                    API_BASE_URL=https://api.example.com
                    ```

                    ### Usage with Claude Desktop

                    Add to your `claude_desktop_config.json`:

                    ```json
                    {
                      "mcpServers": {
                        "china-business": {
                          "command": "node",
                          "args": ["path/to/china-business-mcp/index.js"],
                          "env": {
                            "API_KEY": "your_api_key_here",
                            "API_BASE_URL": "https://api.example.com"
                          }
                        }
                      }
                    }
                    ```

                    ## Available Tools

                    ### `query_company`

                    Query Chinese company information by company name.

                    **Parameters:**
                    - `companyName` (string): The registered company name in Chinese
                    -
                    - **Example:**
                    - ```json
                      {
                        "companyName": "阿里巴巴集团控股有限公司"
                      }
                      ```

                      ## Commercial Use

                      For API key and commercial access:
                      - Monthly subscription: **$9.99/month**
                      - - Send payment to: **paypal.me/duanjianan**
                        - - After payment, email **duanjn@foxmail.com** with your transaction ID
                          - - You'll receive your API key and setup instructions within 24 hours
                            -
                            - ## License
                            -
                            - MIT
                            - - Node.js 18+
- A valid API key from a Chinese business data provider (e.g., Tianyancha, Qichacha)

### Setup

1. Clone the repository:
```bash
git clone https://github.com/novalab/china-business-mcp.git
cd china-business-mcp
```

2. Install dependencies:
```bash
npm install
```

3. Create a `.env` file:
```bash
cp .env.example .env
```

4. Add your API key to `.env`:
```
API_KEY=your_api_key_here
API_BASE_URL=https://api.example.com
```

### Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "china-business": {
      "command": "node",
      "args": ["path/to/china-business-mcp/index.js"],
      "env": {
        "API_KEY": "your_api_key_here",
        "API_BASE_URL": "https://api.example.com"
      }
    }
  }
}
```

## Available Tools

### `query_company`

Query Chinese company information by company name.

**Parameters:**
- `companyName` (string): The registered company name in Chinese

**Example:**
```json
{
  "companyName": "阿里巴巴集团控股有限公司"
}
```

## Development

```bash
npm run dev
```

## License

MIT