台灣FDA藥品查詢MCP服務器
這是一個基於FastMCP框架開發的台灣FDA藥品查詢服務器，提供了完整的藥品資訊查詢和仿單下載功能。
功能特色
🔍 核心查詢功能
英文品名查詢 (
search_drugs_by_english_name)根據英文品名關鍵字查詢藥品
返回詳細的藥品資訊包括許可證號、中文品名、英文品名、申請商等
自動提取仿單GUID供下載使用
進階多條件查詢 (
advanced_drug_search)支援許可證號、中文品名、英文品名、申請商、有效成分等多種查詢條件
可組合使用多個查詢條件進行精確搜索
支援模糊搜索和部分匹配
🔐 驗證碼處理
驗證碼圖片獲取 (
get_captcha_image)自動獲取台灣FDA網站的4位數字驗證碼
返回Base64編碼的圖片和識別提示
支援重新獲取驗證碼功能
📄 仿單下載功能
單個仿單下載 (
download_insert)使用藥品GUID下載對應的PDF仿單
自動檢查文件完整性和格式
支援自定義輸出路徑
批量仿單下載 (
batch_download_inserts)批量下載多個藥品的仿單
自動生成有序的文件名
提供詳細的下載結果統計
🛠️ 輔助工具
結果格式化 (
format_search_results_tool)將原始查詢結果轉換為易讀的格式
結構化展示藥品資訊
便於數據分析和處理
技術架構
依賴庫
FastMCP - MCP框架
requests - HTTP請求處理
beautifulsoup4 - HTML解析
Pillow - 圖像處理
uv - 項目管理和依賴安裝
網站端點
查詢API:
https://mcp.fda.gov.tw/q_insert/qcase_01A1.asp(POST)驗證碼:
https://mcp.fda.gov.tw/CheckCode.aspx(GET)仿單下載:
https://mcp.fda.gov.tw/insert/pdfcasefile/{guid}(GET)
安裝與部署
前置要求
Python 3.10+
uv包管理器
部署步驟
克隆或下載項目
# 項目目錄 /workspace/fda-taiwan-mcp/啟動MCP服務器
# 自動創建虛擬環境並安裝依賴 sh run.sh配置MCP客戶端
{ "name": "agent_generated_fda_taiwan_drug_search", "command": "sh /workspace/fda-taiwan-mcp/run.sh" }
使用指南
基本使用流程
獲取驗證碼
工具: get_captcha_image 返回: Base64編碼的驗證碼圖片識別驗證碼
查看返回的驗證碼圖片
手動識別圖片中的4位數字
查詢藥品
工具: search_drugs_by_english_name 參數: - english_name: "aspirin" - captcha: "1234" # 剛才識別的驗證碼下載仿單
工具: download_insert 參數: - guid: "從查詢結果中獲得的GUID" - output_path: "/path/to/save/drug_insert.pdf"
範例使用場景
場景1：查詢常見藥品
場景2：進階查詢
場景3：批量處理
錯誤處理
常見錯誤及解決方案
驗證碼錯誤
錯誤：
驗證碼必須是4位數字解決：重新獲取驗證碼圖片並仔細識別
查無結果
錯誤：
未找到符合條件的藥品資訊解決：檢查查詢條件，嘗試使用更寬鬆的搜索條件
網路連接問題
錯誤：
網路請求失敗解決：檢查網路連接，稍後重試
仿單下載失敗
錯誤：
下載的內容不是有效的PDF文件解決：檢查GUID是否正確，確認網路連接
注意事項
使用限制
每次查詢需要4位數字驗證碼
查詢頻率建議間隔1-2秒避免被封鎖
大量查詢建議使用批量處理功能
安全考量
驗證碼需要人工識別，無法自動化
適當的請求延遲避免對服務器造成壓力
下載的PDF文件建議進行安全檢查
性能優化
使用批量下載功能提高效率
合理設置請求延遲
及時清理臨時文件
開發與貢獻
項目結構
擴展開發
可以在
tools.py中添加新的查詢功能支持擴展新的網站端點
可以添加更多的數據處理和格式化功能
版本信息
版本: 1.0.0
作者: MiniMax Agent
更新日期: 2025-11-05
Python版本: 3.10+
MCP版本: FastMCP 2.13+
許可證
此項目遵循MIT許可證。
技術支持
如有問題或建議，請通過以下方式聯繫：
創建Issue描述問題
提交Pull Request貢獻代碼
查看文檔尋找解決方案
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables searching Taiwan FDA drug database by various criteria (English/Chinese names, license numbers, ingredients), retrieving drug information, and downloading PDF package inserts with CAPTCHA verification support.