使用說明

項目簡介

本項目為一個 MCP (Model Context Protocol) 伺服器，旨在向 LLM 應用程式提供台灣各地空氣品質監測站的數據。透過本伺服器，LLM 可以獲取即時以及過去 24 小時的空氣品質資訊，並利用這些資訊提供更豐富的上下文感知服務。

主要功能點

• 即時空氣品質查詢: 獲取台灣各地空氣品質監測站的當前空氣品質數據。
• 歷史空氣品質查詢: 獲取過去 24 小時內的空氣品質數據。
• 健康建議: 根據空氣品質數據提供相應的健康指導建議。

安裝步驟

1. 下載 PHP: 確保您的電腦已安裝 PHP 8.2.x 或更高版本。您可以從 PHP 官網 下載。
2. 下載並解壓縮伺服器程式: 下載本倉庫提供的打包檔案，並將其解壓縮到您電腦的指定目錄。
3. 修改 MCP 伺服器配置: 編輯您的 MCP 客户端（例如 Claude Desktop）的配置文件 'claude_desktop_config.json'。

伺服器配置

在 'claude_desktop_config.json' 檔案中，您需要配置本 MCP 伺服器的啟動命令和參數。在 'mcpServers' 節點下添加或修改 'taiwanaqi' 伺服器的配置，如下所示：

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

• 'command': 設定為 'php'，表示使用 PHP 執行環境。
• 'args': 設定為包含兩個元素的陣列：
  • '[您的伺服器程式路徑]/client.php': 請將 '[您的伺服器程式路徑]' 替換為您解壓縮伺服器程式碼的實際路徑。指向 'client.php' 檔案。
  • 'api_key=YOUR_API_KEY': API Key (可選)。如果伺服器需要 API 金鑰才能訪問空氣品質數據服務，請將 'YOUR_API_KEY' 替換為您的 API 金鑰。如果不需要 API 金鑰，則可以省略此參數。

注意: 請確保 'client.php' 檔案的路徑正確無誤。完成配置後，請儲存 'claude_desktop_config.json' 檔案。

基本使用方法

1. 重啟 MCP 客户端: 重新啟動您的 MCP 客户端應用程式，例如 Claude Desktop，以使配置生效。
2. 驗證工具: 根據 官方說明 操作，在您的 MCP 客户端中確認是否成功註冊以下工具 (Tools)：
   • 'aqi-health-guidance'
   • 'aqi-query'
   • 'aqi-query-recent'

如果成功看到以上工具，則表示您的 MCP 伺服器已成功配置並可以開始使用。您可以在您的 LLM 應用程式中調用這些工具，以獲取台灣空氣品質相關的資訊。