Content
# Taiwan ICD10 Health MCP Server
> 🇹🇼
[](http://hl7.org/fhir/R4/)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
[](LICENSE)
[](https://healthymind-tech.github.io/Taiwan-Health-MCP)
---
## ✨
- 🇹🇼 **Taiwan Localization** - Designed for the Taiwan healthcare environment, supports Traditional Chinese
- 🔗 **Standardized Integration** - Compliant with international FHIR R4, LOINC, ICD-10, ATC standards
- 📊 **Official Data** - Integrates Taiwan FDA, Ministry of Health and Welfare official open data
- 🤖 **AI Integration** - Seamlessly integrates with Claude via the MCP protocol
- 🔄 **Continuous Updates** - Data can be automatically synchronized with the latest information
---
## 🚀 Quick Start
### Installation
```bash
# 1. Clone project
git clone https://github.com/audi0417/Taiwan-Health-MCP.git
cd Taiwan-Health-MCP
# 2. Install dependencies
pip install -r requirements.txt
# 3. Prepare data (download ICD-10 Excel file to data/ directory)
# 4. Start service
python src/server.py
```
### Docker Startup (Recommended)
```bash
docker-compose up -d
```
### 📖 Full Documentation
- **[GitHub Pages Documentation Website](https://healthymind-tech.github.io/Taiwan-Health-MCP/)** - Complete architecture, API, usage guide
- **[Local MkDocs](docs/)** - Offline development documentation
---
## 📋 Core Features
### 1. ICD-10 Diagnosis and Procedure Code Query
- Diagnosis code (ICD-10-CM) and procedure code (ICD-10-PCS) search
- Diagnosis complication inference
- Diagnosis and procedure code conflict check
- Convert to **FHIR Condition** resource
### 2. Taiwan FDA Drug Data Integration
Integrates 5 official datasets:
- Drug permit (name, indication, manufacturer)
- Drug appearance identification (shape, color, scoring, picture)
- Drug ingredients (active ingredient, content)
- ATC drug classification (WHO standard)
- Drug insert/package leaflet
- Convert to **FHIR Medication/MedicationKnowledge** resource
### 3. Health Food Management
- Taiwan FDA approved health food query
- Health Claims query
- Disease and health food association analysis
### 4. Nutrition and Food Management
- Food nutrition content query
- Dietary nutrition analysis
- Food ingredient/additive query
### 5. LOINC Test Code Integration
- LOINC code mapping (30+ commonly used in Taiwan, expandable to 87,000+)
- Test reference value query (by age, gender)
- Automatic interpretation of test results
- Batch interpretation of multiple tests
### 6. Clinical Practice Guidelines
- Taiwan Medical Association clinical guideline query
- Diagnosis recommendations, medication recommendations, examination recommendations
- Treatment goals and clinical pathway planning
### 7. FHIR R4 Standard Conversion
- **FHIR Condition** - ICD-10 diagnosis resource
- **FHIR Medication** - Drug resource
- **FHIR MedicationKnowledge** - Drug knowledge base
- Compliant with international medical information exchange standards
> ⚠️ **FHIR Implementation Limitations**
>
> - **FHIR Condition**: Core structure is complete, but validation does not cover all R4 constraint rules (only checks required fields)
> - **FHIR Medication**: Supports basic structure, ingredient content unit hardcoded to "mg", does not support complex unit conversion
> - **Validation Function**: Basic validation (required fields, resource type), does not cover advanced validation and complete terminology binding check
> - **Production Environment**: If used in a production medical system, it is recommended to integrate [HL7 FHIR Validator](https://www.hl7.org/fhir/validation.html) for complete validation
> - **Application Scenarios**: Suitable for demonstration, MCP integration, research purposes; additional validation layer required for production medical systems
> ⚠️ **Health Food and Dietary Advice Notes**
> The health food analysis and dietary advice functions of this service (including `Disease and Health Food Association Analysis` and `Dietary Nutrition Advice`) are **still in the development and testing phase**, as detailed below:
>
> - **Data Source**: The correspondence between disease codes and health benefits, and the content of dietary advice are currently **compiled by the developer** and have not been formally reviewed by professional medical/nutritionists
> - **Professional Validation Required**: Any recommendations generated using this function **must be reviewed and signed by a certified nutritionist, physician, or related healthcare professional** before being applied to actual medical or health guidance
> - **Regulatory Compliance**: Health foods are regulated by the Taiwan Ministry of Health and Welfare in accordance with the "Health Food Management Act". The recommendations provided by this service do not constitute medical diagnosis, treatment, or prescription
> - **Development Stage**: The disease-health benefit correspondence table (see lines 29-79 of `src/health_food_service.py`) needs to be verified for compliance with the list of benefits approved by the Taiwan FDA; the content of dietary advice (see lines 414-438 of `src/health_food_service.py`) needs to be confirmed by nutrition experts for accuracy of details
> - **Applicable Scenarios**: Currently suitable for developer testing, demonstration, and educational purposes; **not suitable for use in production medical systems or directly facing patients**
> - **Contribution Method**: Welcome to submit Issues or Pull Requests to help supplement or verify medical expertise, see [CONTRIBUTING.md](CONTRIBUTING.md) for details
---
## 🛠️ MCP Tool List
This service provides **32 MCP tools**:
| Category | Quantity | Function |
| --- | --- | --- |
| ICD-10 | 4 | Diagnosis/procedure code search, inference, conflict check |
| Drugs | 3 | FDA drug query, appearance identification |
| Health Foods | 2 | Health food query, health analysis |
| Nutrition | 5 | Nutritional content, dietary analysis |
| FHIR Interoperability | 3 | Condition resource conversion, validation |
| Tests (LOINC) | 5 | Test code, reference value, result interpretation |
| Clinical Guidelines | 5 | Guideline query, treatment pathway |
| FHIR Drugs | 4 | Medication resource conversion |
| Comprehensive Analysis | 1 | Disease and health integration analysis |
---
## 📊 Data Sources
### Taiwan Official Data
- Ministry of Health and Welfare ICD-10 Chinese data
- FDA drug data (5 APIs)
- FDA health food data
### International Standards
- **FHIR R4** - HL7 International
- **LOINC** - Regenstrief Institute
- **ICD-10** - WHO
- **ATC** - WHO
---
## 📦 Version
**v1.1.0** - Complete Taiwan medical health data integration MCP server
See Git commit history or [src/README.md](src/README.md) for feature details.
---
## 🤝 Contribution
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed steps and directions.
<a href="https://github.com/healthymind-tech/Taiwan-Health-MCP/graphs/contributors">
<img src="https://contrib.rocks/image?repo=healthymind-tech/Taiwan-Health-MCP" />
</a>
Made with [contrib.rocks](https://contrib.rocks).
---
## 📝 License
**MIT License** - See [LICENSE](LICENSE) file for details
Open data and standards used:
- Taiwan Government Open Data - Government Data Open License Terms
- LOINC & FHIR & ICD - Free for clinical, research, education
---
## 📞 Contact Information
- **GitHub Issues**: [Report Issues](https://github.com/audi0417/Taiwan-Health-MCP/issues)
- **Email**: [support@healthymind-tech.com](mailto:support@healthymind-tech.com)
- **Documentation**: See [src/README.md](src/README.md)
---
## 🙏 Acknowledgements
Thanks to the organizations that provide open data and standards:
- Taiwan Ministry of Health and Welfare, TFDA (ICD, drug, health food data)
- Regenstrief Institute (LOINC)
- HL7 International (FHIR)
- WHO (ICD, ATC)
---
**⭐ If this project is helpful to you, please give us a Star!**
<picture>
<source
media="(prefers-color-scheme: dark)"
srcset="
https://api.star-history.com/svg?repos=healthymind-tech/Taiwan-Health-MCP&type=Date&theme=dark
"
/>
<source
media="(prefers-color-scheme: light)"
srcset="
https://api.star-history.com/svg?repos=healthymind-tech/Taiwan-Health-MCP&type=Date
"
/>
<img
alt="Star History Chart"
src="https://api.star-history.com/svg?repos=healthymind-tech/Taiwan-Health-MCP&type=Date"
/>
</picture>
