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"
  },
  "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": ["健康檢查", "服務狀態"]
    },
    "tdx_bus_arrival": {
      "name": "tdx_bus_arrival",
      "description": "查詢公車即時到站時間（自動感知用戶位置，找最近站點）",
      "category": "transportation",
      "examples": ["307 公車還要多久", "附近有什麼公車"],
      "module": "features.mcp.tools.tdx_bus_arrival",
      "class": "TDXBusArrivalTool"
    },
    "tdx_metro": {
      "name": "tdx_metro",
      "description": "查詢捷運即時到站、最近車站（台北/高雄/桃園/台中捷運）",
      "category": "transportation",
      "examples": ["最近的捷運站在哪", "台北車站捷運幾分鐘到"],
      "module": "features.mcp.tools.tdx_metro",
      "class": "TDXMetroTool"
    },
    "tdx_parking": {
      "name": "tdx_parking",
      "description": "查詢附近停車場資訊和即時空位",
      "category": "transportation",
      "examples": ["附近停車場", "台北車站附近停車位"],
      "module": "features.mcp.tools.tdx_parking",
      "class": "TDXParkingTool"
    },
    "tdx_thsr": {
      "name": "tdx_thsr",
      "description": "查詢高鐵時刻表、票價和即時資訊",
      "category": "transportation",
      "examples": ["高鐵從台北到台中", "高鐵票價查詢"],
      "module": "features.mcp.tools.tdx_thsr",
      "class": "TDXTHSRTool"
    },
    "tdx_train": {
      "name": "tdx_train",
      "description": "查詢台鐵時刻表和即時資訊",
      "category": "transportation",
      "examples": ["台鐵從台北到新竹", "火車時刻表"],
      "module": "features.mcp.tools.tdx_train",
      "class": "TDXTrainTool"
    },
    "tdx_youbike": {
      "name": "tdx_youbike",
      "description": "查詢 YouBike 站點資訊和即時車輛數量",
      "category": "transportation",
      "examples": ["附近 YouBike", "捷運站 YouBike 數量"],
      "module": "features.mcp.tools.tdx_youbike",
      "class": "TDXBikeTool"
    }
  },
  "environment": {
    "required_env_vars": [
      "WEATHER_API_KEY",
      "NEWSAPI_KEY",
      "TDX_CLIENT_ID",
      "TDX_CLIENT_SECRET",
      "OPENROUTESERVICE_API_KEY"
    ],
    "optional_env_vars": [
      "FIXER_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"
    }
  }
}