内容
<h1 align="center">@opdstar/nhi-mcp</h1>
<p align="center">
<b>台湾全民健康保险计费智能MCP服务器</b><br/>
<sub>核删代码 · 审查条款 · 药品支付规则 · 收费标准 · 特殊材料 · 上诉先例</sub>
</p>
<p align="center">
<a href="https://www.npmjs.com/package/@opdstar/nhi-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@opdstar/nhi-mcp.svg?color=0ea5e9"></a>
<a href="LICENSE"><img alt="MIT" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
<a href="https://opdstar.com"><img alt="Powered by OPDSTAR" src="https://img.shields.io/badge/Powered%20by-OPDSTAR-14b8a6.svg"></a>
<a href="https://modelcontextprotocol.io"><img alt="MCP" src="https://img.shields.io/badge/MCP-compatible-7c3aed.svg"></a>
</p>
<p align="center">
<b>Powered by <a href="https://opdstar.com">OPDSTAR</a></b> — 台灣門診醫師病歷翻譯 + 核刪防護 Co-Pilot
</p>
<p align="center">
<b>繁中总览</b>：<a href="OVERVIEW_ZH.md">OVERVIEW_ZH.md</a> ·
<b>路线图</b>：<a href="ROADMAP.md">ROADMAP.md</a> ·
<b>贡献指南</b>：<a href="CONTRIBUTING.md">CONTRIBUTING.md</a>
</p>
---
## 适用人群
**台湾医疗专业人士 + AI智能代理开发者**，适用于需要权威的台湾全民健康保险参考数据的工具。 将此MCP服务器与Claude Desktop、Cursor、ChatGPT Desktop、Claude.ai或任何MCP兼容的智能代理结合使用，回答以下问题：
- **计费准确性** — 此代码/诊断组合是否会遭到核删？当前授权状态是什么？
- **审查指南** — 全民健康保险审查注意事项对该专科/程序有何规定？
- **药品规则** — 该药物的全民健康保险支付规则是什么？
- **上诉先例** — 是否有人对该核删代码提出上诉？成功率是多少？
- **收费标准** — 该代码的官方积分值和生效日期是多少？
## 范围
本MCP服务器专注于**台湾全民健康保险特有的计费规则和参考数据**。
**不在范围内：**
- 国际标准（SNOMED CT、LOINC、FHIR R4生成、RxNorm）
- 药物相互作用数据库
- 临床决策支持/诊断建议
- 一般的TFDA药品注册查询（OPDSTAR交叉引用但不复制）
OPDSTAR专注于台湾全民健康保险计费智能 — 这是它的强项。
---
## 实际应用场景
### 👩⚕️ 场景1 — 审查风险预检
您正在Claude Desktop编写病历：
> **您：** 我给L30.9慢性湿疹病人开了prednisolone 30mg QD 5天会不会被核删？
> **Claude** （自动调用`lookup_rejection_code` + `get_indicator`）：
>
> 根据全民健康保险审查**008指标**，口服类固醇 + 湿疹类诊断若PE描述不足，会触发核删代码**0320A**。建议：PE补充病灶面积 ≥ 30% 全身，或加入更严重的ICD-10佐证。
>
> 数据来源：OPDSTAR
### 🔍 场景2 — 程序查询
> **您：** 中耳炎H66.9耳鼻喉科能申报哪些处置？
> **Claude** （自动调用`get_procedures_for_icd`）：
>
> - `27002C` 耳镜检查（25点）
> - `27018C` 耳膜穿刺（120点）
> - `36005C` 鼓室通气管置入
>
> 完整列表：各大专科的全民健康保险程序。
### 📚 场景3 — 维基问答
> **您：** 慢性病连续处方箋最长可以开多久？
> **Claude** （自动调用`search_nhi_wiki`）：
>
> 根据全民健康保险署规定，慢性病连续处方箋每次调剂之药品使用期间最长3个月。原文：nhi.gov.tw/ch/cp-XXX.html
---
## 产品介绍
`@opdstar/nhi-mcp`允许任何[模型上下文协议](https://modelcontextprotocol.io)客户端 — Claude Desktop、Cursor、ChatGPT Desktop、自定义智能代理 — **直接查询台湾全民健康保险数据集**，由[OPDSTAR](https://opdstar.com)整理和维护。
用自然语言询问您的智能代理：
> "慢性湿疹L30.9开prednisolone 30mg 5天会不会被核删？"
它会自动调用正确的工具并提取真实的全民健康保险数据：
- **全民健康保险核删代码** （例如`0317A`、`0338A`）及其严重性 + 类别，可按类别（00-09）浏览
- **全民健康保险程序代码** 适用于各大专科，与ICD-10映射
- **全民健康保险审查指标** 及其值和适用药品/诊断
- **全民健康保险审查注意事项** 按程序代码或专科查询，并附风险标识
- **全民健康保险药品目录和药品支付规定** — 搜索药物目录并查找支付规则
- **全民健康保险收费标准** — 当前有效的全民健康保险医疗服务支付项目及支付标准
- **全民健康保险重大伤病范围** 查询和ICD-10反向检查
- **语义 + 全文搜索** 全民健康保险官方维基
- **汇总争议解决信号** 按类别或核删代码（无个别案件详情）
所有这些都通过`opdstar.com`边缘层提供 — 零配置，全球缓存，响应时间不到100毫秒。
---
## 安装
两种方式使用OPDSTAR MCP服务器。
### 选项A — 远程（一步安装，无需安装）
> 可通过[Anthropic MCP目录](https://claude.com/connectors)访问 — 列表正在审核中。
将任何MCP兼容的客户端指向托管的JSON-RPC 2.0端点：
```
POST https://opdstar.com/api/mcp
Content-Type: application/json
```
实时状态、工具列表和数据集新鲜度：[opdstar.com/mcp/status](https://opdstar.com/mcp/status)。
### 选项B — 本地（npm）
```bash
# Claude Desktop — 一行命令，无需安装
npx @opdstar/nhi-mcp
# 或持久化为依赖项
npm install -g @opdstar/nhi-mcp
```
需要 **Node.js 18+**。
### Claude Desktop 配置
将以下内容添加到`~/Library/Application Support/Claude/claude_desktop_config.json`（Mac）或`%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"opdstar-nhi": {
"command": "npx",
"args": ["-y", "@opdstar/nhi-mcp"]
}
}
}
```
重启Claude Desktop。您应该会在工具菜单中看到**24个工具**。
### Cursor 配置
将以下内容添加到`.cursor/mcp.json`您的项目根目录（或全局`~/.cursor/mcp.json`）：
```json
{
"mcpServers": {
"opdstar-nhi": {
"command": "npx",
"args": ["-y", "@opdstar/nhi-mcp"]
}
}
}
```
---
## 工具
### 1. `lookup_rejection_code`
查询台湾全民健康保险核删代码（5位字符，例如`0317A`）。
**参数**：`{ code: string }`
**示例**：
```
> Claude，核删代码0317A是什么意思？
→ [tool calls: lookup_rejection_code(code="0317A")]
→ {
"code": "0317A",
"description": "处方含抗生素，诊断码未见感染性疾病",
"severity": "critical",
"category": "03",
"category_name": "药品特材",
"opdstar_relevant": true,
"source_url": "https://opdstar.com/faq?q=核删代码 0317A"
}
```
### 2. `get_procedures_for_icd`
给定ICD-10代码和专科，返回适用的全民健康保险程序代码。
**参数**：`{ icd10: string, specialty: string, limit?: number }`
**示例**：
```
> 什么是L30.9在皮肤科适用的全民健康保险程序？
→ [tool calls: get_procedures_for_icd(icd10="L30.9", specialty="dermatology", limit=5)]
→ {
"count": 4,
"results": [
{
"code": "48010C",
"name_zh": "伤口处置",
"nhi_points": 125,
"audit_notes": "需记录伤口大小、深度、分泌物",
"source_url": "https://opdstar.com/faq?q=处置码 48010C"
},
...
]
}
```
### 3. `get_indicator`
查询台湾全民健康保险审查指标 — 阈值、适用药品/诊断。
**参数**：`{ code: string }`
**示例**：
```
> 指标008是什么？
→ [tool calls: get_indicator(code="008")]
→ {
"code": "008",
"name": "急性上呼吸道感染抗生素使用率",
"threshold_pct": 10,
"applicable_drugs": ["antibiotic"],
"applicable_icd_patterns": ["J00","J06","J11","J02","J03","J04"],
"severity": "critical",
"rejection_codes": ["0311A", "0349A"]
}
```
### 4. `search_nhi_wiki`
对台湾全民健康保险官方维基（9个类别）进行语义 + 全文搜索。
**参数**：`{ query: string, category?: "audit"|"drugs"|..., limit?: number }`
**示例**：
```
> 搜索全民健康保险维基的慢性病连续处方箋规则
→ [tool calls: search_nhi_wiki(query="慢性病连续处方箋天数上限", category="drugs")]
→ {
"count": 3,
"results": [
{
"title": "慢性病连续处方箋使用规定",
"content": "慢性病连续处方箋每次调剂之药品使用期间，最长以3个月为限...",
"source_url_nhi": "https://www.nhi.gov.tw/ch/cp-XXX.html",
"source_url_opdstar": "https://opdstar.com/ask?q=..."
}
]
}
```
### 5. `get_drug_rules` <sub>v0.2</sub>
台湾全民健康保险药品支付规定查询。至少需要一个过滤器（避免无限返回）。
**参数**：`{ specialty?: string, rejection_code?: string, drug_category_query?: string }`
### 6. `get_safe_phrases` <sub>v0.2 (preview only)</sub>
发现哪些SOAP场景有已知的全民健康保险安全短语。 **预览版** — 返回场景 + 高风险词 + 示例第一句话 + 链接到opdstar.com获取完整库。完整的短语库是付费OPDSTAR产品的一部分。
**参数**：`{ specialty: string, scenario_query?: string }`
### 7. `search_audit_guidelines` <sub>v0.2</sub>
免费文本搜索审查注意事项规则。返回匹配规则的理由和建议摘要。
**参数**：`{ query: string (2+ chars), specialty?: string }`
### 8. `get_rejection_code_category` <sub>v0.2</sub>
列出给定类别（00-09）的所有全民健康保险核删代码。适用于发现 — “显示所有 手术处置核删代码”。
**参数**：`{ category: "00"|"01"|...|"09", opdstar_relevant_only?: boolean }`
10个类别：`00` 诊疗品质 · `01` 病历记录 · `02` 基本诊疗 · `03` 药品特材 · `04` 手术处置 · `05` 检查检验 · `06` 论病例计酬 · `07` 康复精神 · `08` 其他 · `09` 法令
**示例**：
```
> 列出所有手术处置类的核删代码
→ [tool calls: get_rejection_code_category(category="04")]
→ {
"category": "04",
"category_name": "手术处置",
"count": 32,
"results": [
{ "code": "0401A", "description": "...", "severity": "critical", "opdstar_relevant": true },
...
]
}
```
### 9. `lookup_drug` <sub>v0.3</sub>
查询台湾全民健康保险药品目录（活跃药物目录）。按通用名、品牌名、别名或全民健康保险9位代码搜索。有关药物的支付限制，使用`get_drug_rules`单独查询。
**参数**：`{ q: string (≥2 chars), specialty?, dosage_form?, route? }`
**示例**：
```
> 哪些药物与'augmentin'匹配？
→ [tool calls: lookup_drug(q="augmentin")]
→ {
"query": "augmentin",
"count": 4,
"results": [
{ "generic_name": "amoxicillin/clavulanate", "brand_names": ["Augmentin", ...], "strength": "875/125 mg", "dosage_form": "tablet", "nhi_drug_code": "BC25551100", "atc_code": "J01CR02", ... },
...
]
}
```
### 10. `lookup_fee_code` <sub>v0.4</sub>
查询台湾全民健康保险收费标准（全民健康保险医疗服务支付项目及支付标准，当前有效版本）。按确切代码、中文名称或英文名称搜索；按类别前缀过滤（`00`/`P1`/`N2`/...）。
**参数**：`{ q: string (≥2 chars), category?, icd? }`
**示例**：
```
> 一般门诊诊察费的积分是多少？
→ [tool calls: lookup_fee_code(q="00101B")]
→ {
"query": "00101B",
"count": 1,
"results": [
{
"code": "00101B",
"category_prefix": "00",
"section": "第二部 西医",
"name_zh": "一般门诊诊察费－医院门诊诊察费（不含牙科门诊）...",
"points": 286,
"effective_start": "2021-03-01",
"audit_notes": "1. 处方交付特约药局调剂或未开处方者，不得申报药品服务费...",
"audit_notes_full_length": 148
}
]
}
```
> 注意：`applicable_icd_pattern`是OPDSTAR整理的稀疏数据 — 原始全民健康保险数据无ICD-10映射。`icd`过滤器仅匹配已丰富代码。
### 11. `lookup_audit_clauses_for_procedure` <sub>v0.5</sub>
查找官方审查注意事项条款，引用特定全民健康保险程序代码。返回条款摘要，附风险标识（`amount_limit` / `frequency_rule` / `indication`）。
**参数**：`{ procedure_code: string, specialty?: string }`
**示例**：
```
> 处置码 51017C 有哪些审查注意事项？
→ [tool calls: lookup_audit_clauses_for_procedure(procedure_code="51017C")]
→ {
"count": 3,
"results": [
{
"clause_headline": "...",
"specialty": "...",
"risk_flags": ["amount_limit"],
"source_url": "https://opdstar.com/..."
},
...
]
}
```
### 12. `lookup_audit_clauses_for_specialty` <sub>v0.5</sub>
按专科（皮肤科 / 中医 / 牙科 / 眼科等）浏览审查注意事项。按关键词和风险标识过滤。
**参数**：`{ specialty: string, keyword?: string, risk_flag?: "amount_limit"|"frequency_rule"|"indication"|"any" }`
### 13. `lookup_major_illness` <sub>v0.5</sub>
浏览官方重大伤病范围及项目列表。返回类别代码、名称、ICD-10覆盖范围、申请要求、有效期和共付费豁免状态。
**参数**：`{ category_code?: string, keyword?: string }`
### 14. `check_icd_for_major_illness_eligibility` <sub>v0.5</sub>
反向查询。给定ICD-10代码，返回诊断可能符合的重大伤病类别。对于MCP智能代理协助计费编码时，提示共付费豁免非常有用。
**参数**：`{ icd_code: string }`
### 15. `lookup_audit_indicator` <sub>v0.5</sub>
查找官方分析审查不予支付指标（基于阈值的审查规则）。返回指标名称、类别、阈值百分比、适用专科、监控程序代码和官方处理描述。
**参数**：`{ indicator_code?: string, category?: string, specialty?: string, procedure_code?: string }`
**示例**：
```
> '23401C' 被哪个指标监控？
→ [tool calls: lookup_audit_indicator(procedure_code="23401C")]
→ {
"count": 1,
"results": [{
"indicator_code": "001",
"name": "眼科局部处置申报率",
"threshold_pct": 30,
"applicable_specialty": "ophthalmology",
...
}]
}
```
### 16. `lookup_appeal_statistics_by_category` <sub>v0.6</sub>
按类别汇总争议解决信号（药物/程序/费用计算/资格等）。返回抽象容量桶（`few` / `several` / `many`）和索赔者胜率信号（`rare` / `occasional` / `moderate` / `common`）在解决各个阶段。
**参数**：`{ dispute_category: string, stage_tier?: string }`
> 仅汇总信号 — 无个别案件详情，无案件编号，无参数。完整的实现上下文位于opdstar.com。
### 17. `count_appeal_precedents_for_rejection_code` <sub>v0.2</sub>
返回涉及特定全民健康保险核删或程序代码的争议解决数量 + 索赔者胜率信号。对于估计代码的争议通常如何解决非常有用。
**参数**：`{ rejection_code?: string, procedure_code?: string }`
> 仅汇总信号 — 与#16相同的保护模式。
### 18. `recent_nhi_amendments` <sub>v0.7</sub>
列出最近的全民健康保险署「医疗费用审查注意事项」修正公告（近一年修正公告）。返回生效/公告日期、标题、类型（主要 vs 比较）和直接链接到官方DOCX / ODT / PDF。
**参数**：`{ since_days?: number, type?: 'primary' | 'comparison' | 'all', limit?: number }`
### 19. `search_taiwan_drug` <sub>v0.7</sub>
台湾药品统一查询，涵盖全民健康保险和TFDA注册目录。返回通用名（EN + 中文）、品牌名、全民健康保险9码、ATC代码、剂型、强度、途径、专科和有效日期。自动检测输入为全民健康保险9码/ATC代码/通用名/品牌名/别名。
**参数**：`{ query?: string, atc_prefix?: string, form?: string, limit?: number }`
### 20. `lookup_icd10_cm` <sub>v0.7</sub>
查询ICD-10-CM代码，提供英文/中文描述、类别和每个代码适用的OPDSTAR专科。支持自由文本关键词搜索。
**参数**：`{ code?: string, keyword?: string, lang?: 'en' | 'zh' | 'both', limit?: number }`
> 目前由OPDSTAR专科键控的台湾相关子集支持；完整的CMS公共领域ICD-10-CM 2025集合将在后续版本中合并。
### 21. `search_nhi_interpretations` <sub>v0.8</sub>
搜索台湾官方全民健康保险行政解释（全民健康保险署行政函释/函令）— 澄清支付规则、药物目录规定和审查政策的具有约束力的公告和解释函。返回排名靠前的摘要，每个摘要包含官方文件编号（字号）、发布日期、主旨、内容摘要和政府来源URL。
**参数**：`{ query: string, limit?: number }`
> 仅供参考 — 官方全民健康保险署/卫生福利部出版物具有权威性；打开源URL获取约束文本。
### 22. `lookup_preventive_service` <sub>v0.9</sub>
浏览台湾全民健康保险预防保健和筛查服务 — 成人健康检查、主要癌症筛查（乳腺、宫颈、结肠、口腔、肺部LDCT）、产前保健、儿童预防健康、儿童牙科氟化物和窝沟封闭剂计划。返回每项服务的适用人群、年龄/性别资格、补贴频率和筛查工具。
**参数**：`{ category?: string, keyword?: string }`
> 仅供参考 — 资格和补贴遵循卫生福利部公告；筛查提供者在服务点确认资格。
---
### 23. `lookup_chronic_prescription_rule` <sub>v0.9</sub>
查询台湾全民健康保险慢性病连续处方箋规则。根据 ICD-10 代码或疾病名称，返回该病症是否属于官方慢性病范围及其发放限制 — 每次发放最大天数、总用药最大天数和处方有效期。
**参数**: `{ icd_code?: string, disease?: string, category?: string }`
> 仅供参考 — 开具处方的医生确认患者的病情稳定，根据官方《全民健康保险医疗办法》慢性病范围。
---
### 24. `lookup_point_value` <sub>v0.9</sub>
查询台湾全民健康保险浮动点值 — 按地区和总预算部门结算的每点支付金额。台湾全民健康保险在全球预算下采用积分系统进行报销，因此一个申报积分通常价值不到新台币 1 元。没有年份时，返回最新结算的每地区 × 部门的值；有年份时，返回季度时间序列。有助于估算实际报销金额（申报积分 × 点值 ≈ 支付金额）。
**参数**: `{ region?: string, sector?: string, year?: number, quarter?: number, metric?: string }`
> 仅供参考 — 官方数据由卫生福利部中央健康保险署每季度发布。
---
## 工作原理
```
┌────────────────────┐
│ Claude Desktop │
│ Cursor / ChatGPT │ (任何 MCP 客户端)
└──────────┬─────────┘
│ MCP (stdio)
▼
┌────────────────────┐
│ @opdstar/nhi-mcp │ (npm: stdio · 或远程: HTTPS JSON-RPC)
│ 24 个只读工具 │
└──────────┬─────────┘
│ HTTPS
▼
┌────────────────────┐
│ opdstar.com │ 边缘代理，全球缓存
│ /api/mcp/* │
└──────────┬─────────┘
│
▼
┌────────────────────┐
│ OPDSTAR 后端 │ 精选的全民健康保险知识库
└────────────────────┘
```
**为什么通过 opdstar.com 代理？**
1. **单一真实来源** — 数据更新立即生效，无需重新发布 npm
2. **限速和缓存** — 边缘代理吸收流量峰值
3. **无需配置** — 无需 API 密钥，无需秘密，无需设置
**预发布环境覆盖**: 在您的 MCP 客户端环境中设置 `OPDSTAR_API_BASE=https://staging.opdstar.com/api/mcp` ，以指向预发布环境（适用于插件作者 / OPDSTAR 团队）。
---
## 定位与免责声明
`@opdstar/nhi-mcp` 是一个**参考/翻译工具**。它：
- ✅ 查询台湾全民健康保险公共数据和官方维基内容
- ✅ 返回结构化的 JSON 以供 AI 推理
- ❌ 不进行诊断或开处方建议
- ❌ 不构成临床决策支持（SaMD）
最终的临床判断仍由治疗医生做出。对于与 OPDSTAR 多层风险预测的端到端审计，请使用 [opdstar.com](https://opdstar.com) 上的完整应用程序。
数据来源于 [健保署全球資訊網](https://www.nhi.gov.tw/) （公共）和由 OPDSTAR 团队精选。
---
## 常见问题
### 什么是模型上下文协议（MCP）？
MCP 是 Anthropic 在 2024 年 11 月发布的开放标准，允许 AI 助手通过标准化协议调用外部工具。可以将其视为“AI 代理的 USB-C 接口” — 编写一次服务器，任何兼容 MCP 的客户端（Claude Desktop、Cursor、ChatGPT Desktop、Continue、Zed、自定义代理）都可以与其通信，无需自定义集成代码。官方规范：[modelcontextprotocol.io](https://modelcontextprotocol.io)。
### 什么是台湾的全民健康保险（NHI）？
台湾的 **全民健康保险** 是一种单一支付者全民医疗保健系统，自 1995 年起覆盖了 99.9% 的台湾人口。它维护了一套广泛的申报审核规则 — 提交不符合规定的申报的医生将面临 **核删（拒绝）** 并损失实际收入。此 MCP 服务器公开了医生需要了解这些规则的代码、规则和维基内容。
### 谁应该安装这个？
三个受众：
- **台湾医生** 使用 AI 助手（Claude Desktop、Cursor）希望在编写病历时实时查询全民健康保险代码和审计风险洞察
- **医院信息系统 / 诊所软件供应商** 集成 AI 功能 — 零成本访问精选的全民健康保险数据集，而不是手动抓取健保署数据
- **研究人员** 研究台湾医疗保健系统，需要结构化、可查询的拒绝代码、程序和审计指标的访问
### 我需要 OPDSTAR 账户或 API 密钥吗？
**不需要。** MCP 在 MIT 许可下完全公开且免费。无需账户，无需 API 密钥，无需注册。`opdstar.com` 上的代理层基于 IP 而非身份进行速率限制。
### 这是官方全民健康保险产品吗？
**不是。** 它由 OPDSTAR 团队独立开发。所有数据均来源于公开可用的健保署出版物和网站。我们与台湾全民健康保险管理局没有关联、没有获得授权，也不是官方代表。如需权威指导，请始终查阅官方全民健康保险出版物。
### 会发送患者数据吗？
**不会发送患者数据。** 这些工具仅查询公共全民健康保险数据（代码、程序、维基摘录）。当您询问“0317A 是否适用于 L30.9？”时，MCP 只发送代码和诊断名称 — 永远不会发送患者姓名、ID 或临床笔记。`opdstar.com` 上的代理不会记录查询内容（仅聚合计数用于速率限制）。
### 数据多久更新一次？
每月更新。OPDSTAR 团队在健保署发布新规则或修订时同步结构化表格和维基片段。在 GitHub 上关注 [@opdstar](https://github.com/tatsuju/opdstar-nhi-mcp) 或查看 [CHANGELOG.md](CHANGELOG.md) 以获取更改信息。
### 我可以在商业上使用它吗？
**可以。** MIT 许可允许无限制的商业使用。您可以将 `@opdstar/nhi-mcp` 嵌入付费产品中，无需支付版税。我们只要求在工具响应中保留 `powered_by` 属性（它内置且不应被删除）。
### 支持哪些语言？在英文环境下可以使用吗？
工具参数和响应支持 **繁体中文（繁體中文）** 和 **英文**。底层全民健康保险数据主要是繁体中文 — 像 `name_zh` 这样的中文键始终已填充；`name_en` 在健保署提供英文翻译时填充。AI 助手可以无缝处理语言切换。
### 这可以取代完整 OPDSTAR SaaS 产品吗？
**不可以 — 不同的范围。** 此 MCP 提供只读查询。完整的 [OPDSTAR](https://opdstar.com) 产品提供 AI 驱动的病历翻译、实时审计风险检测、安全短语建议和个性化处方跟踪 — 基于闭源临床逻辑和精选的知识库。
### 如何报告错误数据或提出新工具？
使用我们的模板在 GitHub 上提交问题：
- [🐛 错误报告](https://github.com/tatsuju/opdstar-nhi-mcp/issues/new?template=bug_report.md) — 数据错误，工具崩溃
- [💡 新工具提案](https://github.com/tatsuju/opdstar-nhi-mcp/issues/new?template=new_tool_proposal.md) — 您希望我们添加一个尚未拥有的工具
- [💬 讨论](https://github.com/tatsuju/opdstar-nhi-mcp/discussions) — 一般问题，展示和分享
对于敏感问题：`support@opdstar.com`。
---
## 受信任的数据源
所有数据均来源于台湾全民健康保险在 [健保署全球資訊網](https://www.nhi.gov.tw/) 上公开发布的出版物 — 涵盖审计、支付和费用计划参考。
数据与最新的官方出版物保持同步。
---
## 使用者
- **[OPDSTAR](https://opdstar.com)** — 面向台湾门诊医生的病历翻译 + 审计风险预防 SaaS。自 2026-04 起已投入生产使用。
- _您的组织 — 发送 PR 将其添加到此列表中！_
---
## 开放与封闭
**开放（此软件包）**：纯粹的查询工具，基于已经公开的全民健康保险数据。
**封闭（OPDSTAR 的护城河）**：OPDSTAR 临床产品（病历工作流、审计风险预防、个性化功能）是闭源的，仅限于 [opdstar.com](https://opdstar.com)。
---
## 路线图
在 [CHANGELOG.md](CHANGELOG.md) 中查看每个版本的更新历史。高级别方向位于 [ROADMAP.md](ROADMAP.md)。通过 GitHub Issues 使用 `new_tool_proposal` 模板欢迎提出新工具的建议 — 请参阅 CONTRIBUTING.md。
---
## 开发
```bash
git clone https://github.com/tatsuju/opdstar-nhi-mcp.git
cd opdstar-nhi-mcp
npm install
npm test # vitest，8 个离线单元测试
npm run build # tsup → dist/index.js
```
指向您的本地开发服务器：
```bash
OPDSTAR_API_BASE=http://localhost:3000/api/mcp node dist/index.js
```
---
## 贡献 — 欢迎拉取请求 🙌
这是一个 **开源、社区驱动** 的 MIT 许可项目。任何人都可以贡献：
- 🐛 **错误报告** — [提交问题](https://github.com/tatsuju/opdstar-nhi-mcp/issues/new/choose) 并使用我们的错误模板
- 💡 **新工具提案** — [开始讨论](https://github.com/tatsuju/opdstar-nhi-mcp/issues/new/choose) 并使用工具提案模板；我们在您投入 PR 之前会审查其适用性
- 🌐 **翻译 / 文档** — 改善英文/繁体中文的清晰度
- 📦 **MCP 客户端配置** — 为 Continue.dev、Zed、自定义代理添加示例
- 🧪 **更多测试** — 边缘情况、负路径、集成测试
### 如何发送 PR
1. 分叉 `tatsuju/opdstar-nhi-mcp`
2. 创建一个功能分支：`git checkout -b add-something`
3. 进行更改，运行 `npm test` + `npm run typecheck` + `npm run build`
4. 使用约定提交消息：`feat(tool): add get_drug_rules`
5. 推送 + 打开 PR — GitHub 的 PR 模板将指导您完成检查清单
### 我们不会接受的内容
根据 [CONTRIBUTING.md](CONTRIBUTING.md)：
- 生成临床诊断或建议的工具（SaMD 边界）
- 暴露 OPDSTAR 私有审计引擎或提示模板的工具
- 删除 `powered_by` / `source_url` 属性
其他一切 — 我们真诚地欢迎您。 📬 敏感问题：`support@opdstar.com`。
---
## 相关项目
- [mcp-taiwan-legal-db](https://github.com/lawchat-oss/mcp-taiwan-legal-db) — 台湾法律数据 MCP
- [OPDSTAR](https://opdstar.com) — 此 MCP 链接回的完整应用
---
## 许可
[MIT](LICENSE) © OPDSTAR 团队
---
<p align="center">
由 <a href="https://opdstar.com">OPDSTAR</a> 团队构建 · 台北，台湾
</p>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器