{ "mcpServers": { "features-server": { "command": "python", "args": ["-m", "features.mcp.server"], "env": { "PYTHONPATH": "." } }, "filesystem": { "command": "npx", "args": [ "@modelcontextprotocol/server-filesystem@latest", "/Users/baidongqu/Desktop" ], "description": "文件系統操作工具", "enabled": false } }, "server_info": { "name": "features-mcp-server", "version": "2.0.0", "description": "MCP 功能服務器，提供天氣、新聞、匯率等查詢功能", "protocol_version": "2024-11-05" }, "openai_tools": { "web_search": { "enabled": true, "description": "OpenAI hosted web_search tool for current public information" }, "file_search": { "enabled": false, "disabled_reason": "Not used by this project until vector stores are explicitly configured" }, "remote_mcp": { "enabled": true, "approval_default": "always", "items": [] }, "skills": { "enabled": true, "mode": "system_context", "skills_root": "features/mcp/skills" } }, "tools": { "system_list_features": { "name": "system_list_features", "description": "列出所有可用的 MCP 功能", "category": "system", "examples": ["功能列表", "有什麼功能"] }, "system_health_check": { "name": "system_health_check", "description": "檢查 MCP 服務器健康狀態", "category": "system", "examples": ["健康檢查", "服務狀態"] }, "environment_context": { "name": "environment_context", "description": "取得使用者目前環境感知資料（位置、時區、語言、裝置、活動狀態）", "category": "environment", "examples": ["我現在在哪", "目前環境資訊"], "module": "features.mcp.tools.environment.context_tool", "class": "EnvironmentContextTool" }, "weather_query": { "name": "weather_query", "description": "查詢即時天氣資訊", "category": "location", "examples": ["台北天氣", "今天會下雨嗎"], "module": "features.mcp.tools.location.weather_tool", "class": "WeatherTool" }, "reverse_geocode": { "name": "reverse_geocode", "description": "將座標轉換成地址、城市與行政區", "category": "location", "examples": ["我在哪裡", "這個座標是哪裡"], "module": "features.mcp.tools.location.geocode_tool", "class": "ReverseGeocodeTool" }, "forward_geocode": { "name": "forward_geocode", "description": "將地點名稱轉換成座標", "category": "location", "examples": ["銘傳大學在哪", "台北車站座標"], "module": "features.mcp.tools.location.geocoding_tool", "class": "ForwardGeocodeTool" }, "directions": { "name": "directions", "description": "規劃兩點之間的路線", "category": "location", "examples": ["從這裡到台北車站怎麼走", "幫我規劃路線"], "module": "features.mcp.tools.location.directions_tool", "class": "DirectionsTool" }, "tdx_bus_arrival": { "name": "tdx_bus_arrival", "description": "查詢公車即時到站時間（自動感知用戶位置，找最近站點）", "category": "transportation", "examples": ["307 公車還要多久", "附近有什麼公車"], "module": "features.mcp.tools.transportation.tdx_bus_arrival", "class": "TDXBusArrivalTool" }, "tdx_metro": { "name": "tdx_metro", "description": "查詢捷運即時到站、最近車站（台北/高雄/桃園/台中捷運）", "category": "transportation", "examples": ["最近的捷運站在哪", "台北車站捷運幾分鐘到"], "module": "features.mcp.tools.transportation.tdx_metro", "class": "TDXMetroTool" }, "tdx_parking": { "name": "tdx_parking", "description": "查詢附近停車場資訊和即時空位", "category": "transportation", "examples": ["附近停車場", "台北車站附近停車位"], "module": "features.mcp.tools.transportation.tdx_parking", "class": "TDXParkingTool" }, "tdx_thsr": { "name": "tdx_thsr", "description": "查詢高鐵時刻表、票價和即時資訊", "category": "transportation", "examples": ["高鐵從台北到台中", "高鐵票價查詢"], "module": "features.mcp.tools.transportation.tdx_thsr", "class": "TDXTHSRTool" }, "tdx_train": { "name": "tdx_train", "description": "查詢台鐵時刻表和即時資訊", "category": "transportation", "examples": ["台鐵從台北到新竹", "火車時刻表"], "module": "features.mcp.tools.transportation.tdx_train", "class": "TDXTrainTool" }, "tdx_youbike": { "name": "tdx_youbike", "description": "查詢 YouBike 站點資訊和即時車輛數量", "category": "transportation", "examples": ["附近 YouBike", "捷運站 YouBike 數量"], "module": "features.mcp.tools.transportation.tdx_youbike", "class": "TDXBikeTool" }, "news_query": { "name": "news_query", "description": "查詢最新新聞，可指定類別、語言與數量", "category": "utility", "examples": ["今天科技新聞", "台灣最新消息"], "module": "features.mcp.tools.utility.news_tool", "class": "NewsTool" }, "exchange_query": { "name": "exchange_query", "description": "查詢即時匯率並換算貨幣", "category": "utility", "examples": ["100 美元換台幣", "日圓匯率"], "module": "features.mcp.tools.utility.exchange_tool", "class": "ExchangeTool" }, "healthkit_query": { "name": "healthkit_query", "description": "查詢使用者健康資料（心率、步數、血氧、睡眠等）", "category": "utility", "examples": ["我今天走幾步", "最近心率如何"], "module": "features.mcp.tools.utility.healthkit_tool", "class": "HealthKitTool" } }, "environment": { "required_env_vars": [ "WEATHER_API_KEY", "NEWSDATA_API_KEY", "TDX_CLIENT_ID", "TDX_CLIENT_SECRET", "OPENROUTESERVICE_API_KEY" ], "optional_env_vars": [ "FIXER_API_KEY", "EXCHANGE_API_KEY", "HTTP_TIMEOUT" ], "default_values": { "HTTP_TIMEOUT": "12" } }, "usage": { "installation": [ "1. 確保已安裝 Python 3.8+", "2. 安裝依賴: pip install -r requirements.txt", "3. 設置環境變數 (參考 .env.example)", "4. 執行服務器: python -m features.mcp.main_server" ], "examples": [ { "description": "查詢台北天氣", "input": {"name": "weather_query", "arguments": {"city": "台北"}}, "expected_output": "台北天氣資訊，包含溫度、濕度、風速等" }, { "description": "查詢科技新聞", "input": {"name": "news_query", "arguments": {"category": "technology", "language": "zh-TW"}}, "expected_output": "最新科技新聞列表" }, { "description": "美元換台幣", "input": {"name": "exchange_query", "arguments": {"from_currency": "USD", "to_currency": "TWD", "amount": 100}}, "expected_output": "100 美元兌換台幣的金額和匯率資訊" } ] }, "metadata": { "created": "2025-01-XX", "updated": "2025-01-XX", "author": "MCP Features Team", "license": "MIT", "compatibility": { "python_version": ">=3.8", "mcp_version": ">=0.1.0" } } }