使用說明

項目簡介

本項目為一個 MCP (Model Context Protocol) 伺服器，專門提供台灣空氣品質 (AQI) 相關的資訊。透過此伺服器，LLM 應用程式可以獲取台灣各地的空氣品質數據，並利用提供的工具進行查詢，以便在對話或應用中融入相關的環境資訊。

主要功能點

• 即時空氣品質數據： 提供台灣各地空氣品質監測站的最新數據。
• 歷史數據查詢： 可查詢過去 24 小時的空氣品質記錄。
• 健康建議工具： 提供基於空氣品質的健康指導建議。
• 多種查詢工具： 內建多種空氣品質查詢工具，方便 LLM 應用程式靈活使用。
• MCP 協議支援： 完全符合 MCP 協議，可與任何支援 MCP 的 LLM 客户端 (如 Claude Desktop) 無縫整合。

安裝步驟

1. 下載 PHP 8.2.x： 由於本伺服器使用 PHP 開發，請先從 PHP 官網 下載並安裝 PHP 8.2.x 版本。
2. 下載並解壓縮程式碼： 從 GitHub 倉庫下載程式碼壓縮包，並解壓縮到您電腦的指定目錄。
3. 修改設定檔： 編輯 'claude_desktop_config.json' 檔案，配置 MCP 伺服器連線資訊。

伺服器配置

要讓 MCP 客户端 (如 Claude Desktop) 連接此伺服器，您需要在客户端的設定檔中加入以下伺服器配置資訊。請注意，以下配置資訊為 JSON 格式，您需要將其添加到 MCP 客户端的伺服器配置中。

{
  "mcpServers": {
	"taiwanaqi": {
	  "command": "php",
	  "args": [
		"伺服器程式 client.php 的路徑",
		"api_key=您的API金鑰"
		]
	}
  }
}

配置說明：

• '"taiwanaqi"': 伺服器名稱，您可以自訂，用於在 MCP 客户端中識別此伺服器。
• '"command": "php"': 指定啟動伺服器的命令為 'php'，確保您的系統環境變數中已包含 PHP 的執行路徑。
• '"args": [...]' : 啟動伺服器所需的參數列表。
  • '"伺服器程式 client.php 的路徑"': 請將此處替換為您解壓縮程式碼後 'client.php' 檔案的完整路徑。例如：'"D:\[YOUR_PATH_FOLDER]\client.php"'。
  • '"api_key=您的API金鑰"': 如果需要 API 金鑰才能獲取空氣品質數據，請將 '"您的API金鑰"' 替換為您實際的 API 金鑰。如果不需要 API 金鑰，則可能需要移除或修改此參數。請參考程式碼或相關文檔確認是否需要 API 金鑰以及如何獲取。

請注意： 'claude_desktop_config.json' 檔案的路徑和具體配置方式，請參考您使用的 MCP 客户端 (如 Claude Desktop) 的官方文檔。

基本使用方法

1. 重啟 MCP 客户端： 完成伺服器配置後，請重啟您的 MCP 客户端應用程式 (如 Claude Desktop)，使配置生效。
2. 驗證工具是否載入： 依照 官方說明 的步驟操作，檢查 MCP 客户端是否成功載入以下工具：
   • 'aqi-health-guidance'
   • 'aqi-query'
   • 'aqi-query-recent' 如果看到以上工具列表，則表示伺服器已成功連接。
3. 在 LLM 應用中使用工具： 現在您可以在支援 MCP 協議的 LLM 應用程式中，使用以上列出的工具來查詢台灣空氣品質資訊，具體使用方法請參考各工具的說明或 MCP 客户端的介面。