features/mcp_config.json

{
  "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"
    }
  }
}