Content
# Tool List
[This MCP service provides basic query functions such as enterprise business information, enterprise profile, enterprise tags, enterprise business, enterprise holding shareholders information, enterprise external investment information, enterprise branch information, and enterprise main personnel information.](https://www.handaas.com/)
## Main Functions
- 🔍 Enterprise Keyword Fuzzy Search
- 🏢 Enterprise Basic Information Query
- 👥 Enterprise Holding Shareholders Information
- 💰 Enterprise External Investment Information
- 🏪 Enterprise Branch Information
- 👨💼 Enterprise Main Personnel Information
## Environment Requirements
- Python 3.10+
- Dependencies: python-dotenv, requests, mcp
## Quick Local Startup
### 1. Clone Project
```bash
git clone https://github.com/handaas/enterprise-mcp-server
cd enterprise-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 environment variable template and configure:
```bash
cp .env.example .env
```
Edit `.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 or sse or streamable-http
### 5. Cursor / Cherry Studio MCP Configuration
```json
{
"mcpServers": {
"handaas-mcp-server": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}
```
## STDIO Version Installation and Deployment
### Configure Cursor / Cherry Studio MCP
```json
{
"mcpServers": {
"enterprise-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"
}
}
}
}
```
## Using Official Remote Service
### 1. Directly Configure Cursor / Cherry Studio MCP
```json
{
"mcpServers": {
"enterprise-mcp-server":{
"type": "streamableHttp",
"url": "https://mcp.handaas.com/enterprise/enterprise_profile?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 Enterprise by Keyword
Fuzzy query related enterprise list based on provided enterprise name, person name, brand, product, position and other keywords.
**Parameters**:
- `matchKeyword` (required): Matching keyword - query enterprise containing matching keyword in various information.
- `pageIndex` (optional): Pagination start position
- `pageSize` (optional): Pagination end position - up to 50 data per page
**Return Values**:
- `catchReason`: Hit reason
- `address`: Address
- `enterpriseType`: Enterprise type
- `foundTime`: Found time
- `homepage`: Official website
- `legalRepresentative`: Legal representative
- `name`: Enterprise name
- `operStatus`: Operation status
- `regCapitalCoinType`: Registered capital currency type
- `regCapitalValue`: Registered capital
- `annualTurnover`: Annual turnover
### 2. enterprise_get_enterprise_base_info
**Function**: Query Enterprise Basic Information
Query enterprise business related information by inputting enterprise full name, and identify what the company does.
**Parameters**:
- `keyword` (required): Enterprise full name
**Return Values**:
- `base_info`: Enterprise business information
- `desc`: Enterprise profile
- `business_info`: Enterprise business
- `tag`: Enterprise tags
### 3. enterprise_get_enterprise_holder_info
**Function**: Query Enterprise Holding Shareholders Information
Query enterprise holding shareholders information by inputting enterprise full name, which is derived from business information and all data analysis from Kuanghu.
**Parameters**:
- `keyword` (required): Enterprise full name
**Return Values**:
- `holderList`: Shareholders list (business publicity)
- `entityType`: Subject type
- `holderType`: Shareholder type
- `name`: Shareholder name
- `nameId`: Enterprise ID
- `humanId`: Person ID
- `payAmount`: Paid amount
- `ratio`: Shareholding ratio
- `subscriptionDetail`: Subscription information
- `stockHolderList`: Shareholders list (latest publicity) from listing information
### 4. enterprise_get_enterprise_invest_info
**Function**: Query Enterprise External Investment Information
Query enterprise external investment information by inputting enterprise full name, which is derived from business information and all data analysis from Kuanghu.
**Parameters**:
- `keyword` (required): Enterprise full name
**Return Values**:
- `resultList`: External investment result list
- `addressValue`: Invested company location
- `business`: Invested company business scope
- `foundTime`: Invested company found date
- `isListed`: Invested company listing status
- `legalRepresentative`: Invested company legal representative
- `name`: External investment enterprise name
- `operStatus`: External investment enterprise operation status
- `ratio`: Shareholding ratio
- `regCapital`: Invested company registered capital
- `scCode`: External investment enterprise unified credit code
- `subscriptionAmount`: Investment amount information
### 5. enterprise_get_enterprise_branch_info
**Function**: Query Enterprise Branch Information
Query enterprise branch information by inputting enterprise full name, which is derived from business publicity.
**Parameters**:
- `keyword` (required): Enterprise full name
**Return Values**:
- `resultList`: Branch result list
- `addressValue`: Address information
- `foundTime`: Found time
- `legalRepresentative`: Legal representative
- `name`: Institution name
- `operStatus`: Operation status
- `orgCode`: Organization code
- `registrationAuthority`: Registration authority
- `socialCreditCode`: Unified social credit code
### 6. enterprise_get_enterprise_main_person_info
**Function**: Query Enterprise Main Personnel Information
Query enterprise main personnel information by inputting enterprise full name, which is derived from business publicity.
**Parameters**:
- `keyword` (required): Enterprise full name
**Return Values**:
- `resultList`: Main personnel result list
- `name`: Member name
- `position`: Position
- `ratio`: Shareholding ratio
- `relatedEnterpriseCurrentNum`: Current enterprise number
- `relatedEnterpriseHistoryNum`: Historical enterprise number
## Precautions for Use
1. **Enterprise Full Name Requirement**: When calling interfaces that require enterprise full name, you need to call keyword fuzzy query enterprise interface to complete it before calling this interface.
2. **API Limitation**: When paginating, up to 50 data can be obtained per page.
3. **Error Handling**: All interfaces include error handling, and error information will be returned if query fails.
## Example Questions
### enterprise_get_keyword_search (Enterprise Keyword Fuzzy Search)
1. Help me find enterprise information containing the keyword "探迹".
2. Search enterprise list related to "腾讯".
3. Query company names containing "阿里巴巴".
### enterprise_get_enterprise_base_info (Enterprise Basic Information Query)
1. What does 探迹科技 do?
2. What is the main business of 腾讯科技有限公司?
3. What is the enterprise profile of 北京字节跳动科技有限公司?
### enterprise_get_enterprise_holder_info (Enterprise Holding Shareholders Information)
1. Who are the shareholders of 探迹科技?
2. Who are the holding shareholders of 腾讯?
3. Query the equity structure information of 字节跳动.
### enterprise_get_enterprise_invest_info (Enterprise External Investment Information)
1. Which enterprises has 探迹科技 invested in externally?
2. Which companies has 腾讯 invested in?
3. What are the investment portfolios of 阿里巴巴?
### enterprise_get_enterprise_branch_info (Enterprise Branch Information)
1. What are the subsidiaries of 探迹科技?
2. Where are the branches of 腾讯 located across the country?
3. What is the distribution of 华为's subsidiaries?
### enterprise_get_enterprise_main_person_info (Enterprise Main Personnel Information)
1. Who are the main personnel of 探迹科技?
2. What is the executive team information of 腾讯?
3. What is the core personnel composition of 字节跳动?
