Content
# Tool List
[The MCP service encapsulates HandaaS existing data interfaces commonly used in industry chain analysis, including enterprise big data, supply chain potential customer recommendation, patent big data, and bidding big data, etc., helping users to conduct industry research, enterprise discovery, supply chain expansion, intellectual property analysis, and bidding lead analysis.](https://www.handaas.com/)
## Main Functions
- 🔍 Fuzzy search by enterprise keywords
- 🏢 Query enterprise basic information and business tags
- 🔗 Query downstream products and enterprises in the supply chain
- 📄 Patent information search and enterprise patent statistics
- 📊 Bidding information and procurement statistical analysis
- 🧭 Advanced enterprise filtering
## Environment Requirements
- Python 3.10+
- Dependencies: python-dotenv, requests, mcp
## Quick Start
### 1. Clone the Project
```bash
git clone https://github.com/handaas/industry-chain-mcp-server
cd industry-chain-mcp-server
```
### 2. Create Virtual Environment & Install Dependencies
```bash
python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt
```
### 3. Environment Configuration
Copy the environment variable template and configure:
```bash
cp .env.example .env
```
Edit the `.env` file and configure the following environment variables:
```env
INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
```
### 4. Start Service with streamable-http
```bash
python server/mcp_server.py streamable-http
```
The service will start at `http://localhost:8000`.
#### Supported startup methods: stdio, sse, or streamable-http
### 5. Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"industry-chain-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
```
## STDIO Version Installation and Deployment
### Set Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"industry-chain-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"
}
}
}
}
```
## Use Official Remote Service
### 1. Directly Set Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"industry-chain-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/industry-chain/industry_chain?token={token}"
}
}
}
```
### Note: integrator_id, secret_id, secret_key, and token need to be registered and opened on https://www.handaas.com/ to obtain
## Available Tools
### 1. enterprise_get_keyword_search
**Function**: Fuzzy query by enterprise keywords
Fuzzy query related enterprise list based on provided enterprise name, person name, brand, product, position and other keywords.
**Parameters**:
- `matchKeyword` (required): Matching keywords - query enterprises containing matching keywords in various information
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size - up to 50 data items per page
**Return Value**:
- `total`: Total number
- `resultList`: Enterprise list
- Other enterprise basic information, reasons for hits, etc.
### 2. enterprise_get_enterprise_base_info
**Function**: Query enterprise basic information
Query enterprise basic information based on enterprise name, registration number, unified social credit code or enterprise ID.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `name`: Enterprise name
- `operStatus`: Business status
- `business`: Business scope
- `industry`: Industry information
- `regCapital`: Registered capital
- Other basic business fields
### 3. enterprise_get_enterprise_profile
**Function**: Query enterprise profile
Query enterprise profile information based on enterprise identifier.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `desc`: Enterprise profile description
### 4. enterprise_get_enterprise_business_info
**Function**: Query enterprise business information
Query enterprise business related information to identify enterprise main business, product service and industry chain related capabilities.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- Enterprise business, main products, capability tags and other related information
### 5. enterprise_get_enterprise_tags
**Function**: Query enterprise tags
Query enterprise main business, financing, scale, high-tech, specialized and new tags.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `businessTags`: Main business tags
- `financingSeries`: Financing round
- `enterpriseScaleAlgValue`: Enterprise scale
- `isHighTechEnterprise`: Whether high-tech enterprise
- `isSpecializedAndNew`: Whether specialized and new
- Other enterprise tag fields
### 6. enterprise_get_enterprise_holder_info
**Function**: Query enterprise holding shareholder information
Query enterprise holding shareholder information based on enterprise identifier.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `holderList`: Shareholder list
- `stockHolderList`: Latest public shareholder list
### 7. enterprise_get_enterprise_invest_info
**Function**: Query enterprise external investment information
Query enterprise external investment information based on enterprise identifier.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size
**Return Value**:
- `total`: Total number
- `resultList`: List of external investment enterprises
### 8. enterprise_get_enterprise_branch_info
**Function**: Query enterprise branch information
Query enterprise branch information based on enterprise identifier.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size
**Return Value**:
- `total`: Total number
- `resultList`: Branch list
### 9. enterprise_get_enterprise_main_person_info
**Function**: Query enterprise main personnel information
Query enterprise main personnel information based on enterprise identifier.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size
**Return Value**:
- `total`: Total number
- `resultList`: Main personnel list
### 10. supply_get_down_stream_products
**Function**: Query downstream product catalog
Query downstream product catalog based on supply chain product keywords.
**Parameters**:
- `keywords` (required): Supply chain product keywords, separated by English commas
**Return Value**:
- `total`: Total number
- `resultList`: Downstream product catalog
- `industry`: Downstream industry name
- `products`: Downstream product list
### 11. supply_get_down_stream_enterprises
**Function**: Query downstream enterprise list
Query downstream enterprise list based on specific product name.
**Parameters**:
- `keywords` (required): Supply chain product keywords, separated by English commas
- `mainProducts` (optional): Downstream products, separated by English commas
- `isForeignTrade` (optional): Whether foreign trade enterprise - yes, no
- `factoryInspectionType` (optional): Whether factory inspection - yes, no
- `foundTimeStart` (optional): Founding time start, format yyyy-mm-dd
- `foundTimeEnd` (optional): Founding time end, format yyyy-mm-dd
- `address` (optional): Region, e.g., "Guangdong Province, Shenzhen City" or "Guangdong Province"
- `isTopEnterprise` (optional): Whether 500 strong enterprise - yes, no
- `isHighTechEnterprise` (optional): Whether high-tech enterprise - yes, no
- `isGazelleEnterprise` (optional): Whether gazelle enterprise - yes, no
- `isUnicornEnterprise` (optional): Whether unicorn enterprise - yes, no
- `hasStock` (optional): Whether listed enterprise - yes, no
- `hasDevice` (optional): Whether machinery and equipment enterprise - yes, no
- `hasPack` (optional): Whether packaging and material enterprise - yes, no
- `regCapitalMin` (optional): Minimum registered capital, unit: 10,000 yuan
- `regCapitalMax` (optional): Maximum registered capital, unit: 10,000 yuan
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size
**Return Value**:
- `total`: Total number
- `resultList`: Downstream enterprise list
- `enterpriseId`: Enterprise ID
- `name`: Enterprise name
- `city`: City
- `province`: Province
- `mainProducts`: Main products
- `factoryRecommendReason`: Recommendation reason
- `regCapital`: Registered capital information
### 12. advanced_filter_get_enterprise_count
**Function**: Get enterprise quantity with advanced filtering
Query the number of enterprises that meet the requirements nationwide through advanced filtering conditions. This interface only returns the quantity. If you need to query the enterprise list, please use `advanced_filter_get_enterprise_list`.
**Parameters**:
- `operStatus` (optional): Business status, e.g., "business, revoked" or "!revoked"
- `address` (optional): Address filtering conditions
- `industries` (optional): Industry filtering conditions
- `enterpriseType` (optional): Enterprise type filtering conditions
- `name` (optional): Enterprise name filtering conditions
- `foundTimeGte` (optional): Founding time start, format yyyy-mm-dd
- `foundTimeLte` (optional): Founding time end, format yyyy-mm-dd
- `regCapitalRmbGte` (optional): Minimum registered capital, unit: 10,000 yuan
- `regCapitalRmbLte` (optional): Maximum registered capital, unit: 10,000 yuan
- `totalPayAmountGte` (optional): Minimum paid-in capital, unit: 10,000 yuan
- `totalPayAmountLte` (optional): Maximum paid-in capital, unit: 10,000 yuan
**Return Value**:
- `total`: Number of enterprises that meet the conditions
### 13. advanced_filter_get_enterprise_list
**Function**: Get enterprise list with advanced filtering
Query the list of enterprises that meet the requirements nationwide through advanced filtering conditions, returning up to 500 items.
**Parameters**:
- Same as `advanced_filter_get_enterprise_count`
- `pageIndex` (optional): Page number, maximum page number is 50
- `pageSize` (optional): Page size, maximum 10 items per page
**Return Value**:
- `total`: Total number
- `resultList`: Enterprise list
### 14. patent_bigdata_patent_search
**Function**: Patent information search
Perform precise or fuzzy search by inputting patent name, application number, applicant or agency and other information, and filter by specified patent type.
**Parameters**:
- `matchKeyword` (required): Patent name/patent application number/publication number/applicant/agency
- `pageSize` (optional): Page size - up to 50 data items per page
- `patentType` (optional): Patent type - invention application, utility model, invention authorization, design
- `keywordType` (optional): Search method - patent name, application number/public number, applicant, agency
- `pageIndex` (optional): Page number - starting from 1
**Return Value**:
- `total`: Total number of patents
- `resultList`: Patent list
### 15. patent_bigdata_patent_stats
**Function**: Enterprise patent statistical analysis
Query enterprise patent situation based on enterprise information, including patent status distribution, patent application and authorization trend, distribution by patent type, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `patentDivAppLegalStat`: Patent status distribution
- `patentTypeAppTimeStat`: Patent application trend
- `patentTypePubTimeStat`: Patent authorization trend
- `patentTypeStat`: Patent type distribution
### 16. bid_bigdata_bid_win_stats
**Function**: Enterprise bid winning statistical analysis
Get enterprise bid information winning statistics based on enterprise name, unified social credit code, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `winbidAmountStatList`: Bid winning amount distribution
- `winbidAreaStat`: Regional distribution
- `winbidStatList`: Bid winning target distribution
- `winbidTrend`: Bid winning trend
### 17. bid_bigdata_bidding_info
**Function**: Enterprise bidding information query
Query enterprise participation in bidding information, including announcement type, project region, announcement details and related enterprise information.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `pageSize` (optional): Page size - up to 50 data items per page
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
- `pageIndex` (optional): Page number - starting from 1
**Return Value**:
- `total`: Total number
- `resultList`: Bidding information list
### 18. bid_bigdata_tender_stats
**Function**: Enterprise tender statistical analysis
Get enterprise tender information statistics based on enterprise name, unified social credit code, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `tenderAmountStatList`: Tender amount distribution
- `tenderAreaStat`: Regional distribution
- `tenderStatList`: Tender target distribution
- `tenderTrend`: Tender trend
### 19. bid_bigdata_procurement_stats
**Function**: Enterprise procurement statistical analysis
Get enterprise procurement statistics based on enterprise name or ID, including procurement product distribution, procurement region distribution, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/unified social credit code/enterprise ID
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Value**:
- `purchasingProductStatList`: Procurement product distribution
- `purchasingAreaStatList`: Procurement region distribution
### 20. bid_bigdata_bid_search
**Function**: Bidding Announcement Search
Query and filter bidding announcement information, supporting filtering by announcement type, region, publication time, search mode, project amount, etc.
**Parameters**:
- `matchKeyword` (optional): Search keyword
- `biddingType` (optional): Bidding type JSON array string, e.g., `["Bidding Announcement","Winning Bid Announcement"]`
- `biddingRegion` (optional): Project region JSON array string, e.g., `[["Fujian Province","Xiamen City"]]`
- `biddingAnncPubStartTime` (optional): Announcement publication start time, format yyyy-mm-dd
- `biddingAnncPubEndTime` (optional): Announcement publication end time, format yyyy-mm-dd
- `searchMode` (optional): Search mode - title match, target match, full text match
- `biddingProjectMaxAmount` (optional): Maximum project amount, unit: 10,000 yuan
- `biddingPurchasingType` (optional): Bidding unit type, e.g., "Government, School"
- `biddingProjectMinAmount` (optional): Minimum project amount, unit: 10,000 yuan
- `pageIndex` (optional): Page number
- `pageSize` (optional): Page size - up to 50 items per page
**Return Values**:
- `total`: Total number
- `resultList`: Bidding announcement list
### 21. bid_bigdata_planned_projects
**Function**: Enterprise Planned Projects Query
Query enterprise planned project information, including project content, construction location, equipment to be purchased, publication time, etc.
**Parameters**:
- `matchKeyword` (required): Enterprise name/registration number/uniform social credit code/enterprise ID
- `pageIndex` (optional): Page number - starting from 1
- `pageSize` (optional): Page size - up to 50 items per page
- `keywordType` (optional): Subject type - name, nameId, regNumber, socialCreditCode
**Return Values**:
- `total`: Total number
- `resultList`: Planned project list
## Usage Scenarios
1. **Industry Research**: Use enterprise search, enterprise business information, and enterprise tag recognition to identify related enterprises in the industry chain.
2. **Supply Chain Expansion**: Query downstream products and enterprise lists based on upstream products.
3. **Investment Lead Mining**: Combine advanced filtering, enterprise tags, and supply chain enterprise lists to discover potential investment leads.
4. **Technology and Innovation Analysis**: Query enterprise patent information and patent statistics to assess enterprise technology reserves.
5. **Project and Procurement Analysis**: Query bidding, planned projects, and procurement statistics to determine enterprise project activity.
6. **Enterprise Image Completion**: Query business, introduction, business, shareholders, investment, branch institutions, and main personnel information.
## Usage Precautions
1. **Enterprise Full Name Requirement**: When calling interfaces that require the enterprise full name, if there is no enterprise full name, first call the enterprise keyword fuzzy query interface to obtain the enterprise full name or enterprise ID.
2. **Paging Limitation**: List interfaces usually have a maximum of 50 items per page, and advanced filtering enterprise lists have a maximum of 10 items per page and up to 500 items.
3. **JSON Parameter Format**: `bid_bigdata_bid_search`'s `biddingType` and `biddingRegion` require passing a valid JSON string.
4. **Remote Priority**: It is recommended to use the official Remote service, and the client only needs to configure the platform token.
5. **Credential Security**: Do not submit `.env`, `secret_id`, `secret_key`, or signature when starting locally.
6. **Interface Permission**: Available data depends on the data product permissions that the account has opened.
7. **Fee Reminder**: Real queries may generate interface call fees, please use according to the platform opening rules.
## Usage Question Examples
### enterprise_get_keyword_search (Enterprise Keyword Fuzzy Query)
1. Help me find enterprise information containing "eVTOL".
2. Search for enterprise lists related to "humanoid robot".
3. Query companies with "reducer" in their name or product.
### supply_get_down_stream_products (Downstream Product Directory Query)
1. Query the downstream product directory of "power battery".
2. Help me see what downstream products "carbon fiber material" can be associated with.
3. Query downstream industries and products based on "lidar".
### supply_get_down_stream_enterprises (Downstream Enterprise List Query)
1. Query the downstream enterprise list of "power battery".
2. Help me find downstream enterprises related to "motor controller" in Guangdong Province.
3. Query high-tech downstream enterprises related to "industrial robot".
### advanced_filter_get_enterprise_list (Advanced Filtering to Get Enterprise List)
1. Query the enterprise list in Guangdong Province with a business status and name containing "drone".
2. Filter high-end equipment manufacturing-related enterprises and return the enterprise list.
3. Query robot-related enterprises established after 2020.
### patent_bigdata_patent_search (Patent Information Search)
1. Search for patent information with the keyword "flight control system".
2. Query all invention patents applied by a certain company.
3. Find the patent details with a certain application number.
### patent_bigdata_patent_stats (Enterprise Patent Statistics Analysis)
1. Analyze the patent application trend of a certain company.
2. Query the patent type distribution statistics of a certain enterprise.
3. View the patent status distribution of a certain enterprise.
### bid_bigdata_bidding_info (Enterprise Bidding Information Query)
1. Query the recent bidding information participated by a certain enterprise.
2. View the winning bid projects and bidding project records of a certain company.
3. Query the bidding situation of a certain enterprise in low-altitude economy-related projects.
### bid_bigdata_bid_search (Bidding Announcement Search)
1. Search for winning bid announcements with titles containing "drone".
2. Query the recently released low-altitude economy bidding announcements in Guangdong Province.
3. Find data center bidding projects with a project amount greater than 10 million yuan.
MCP Config
Below is the configuration for this MCP Server. You can copy it directly to Cursor or other MCP clients.
mcp.json
Connection Info
You Might Also Like
No recommendations available