MCP Server Isitdown

🚀 mcp-server-isitdown

mcp-server-isitdown 是一個 MCP 服務器，它藉助查詢 www.isitdownrightnow.com 來檢查網站當前是否離線，為用戶提供便捷的網站狀態查詢服務。

🚀 快速開始

此 MCP 服務器提供了一個簡單的工具，用於檢查網站是否處於離線狀態，並可以獲取最近的 downtime 事件信息。

✨ 主要特性

• 提供 get_website_status 工具，可檢查指定網站是否當前在線或離線，並能獲取最近一次 downtime 的信息。

📦 安裝指南

⚠️ 重要提示

此包尚未發佈到公共倉庫。目前僅可通過源碼安裝。

從源碼安裝

# 克隆倉庫 
git clone https://github.com/yourusername/mcp-server-isitdown.git
cd mcp-server-isitdown

# 使用 uv（推薦）
uv pip install -e .

# 使用 pip
pip install -e .

Claude Desktop 配置

將以下配置添加到你的 claude_desktop_config.json 文件中：

"isitdown": {
  "command": "/path/to/uv",
  "args": [
    "--directory",
    "/path/to/cloned/repo/src",
    "run",
    "mcp_server_isitdown"
  ]
}

💻 使用示例

作為獨立的 MCP 服務器運行

# 使用安裝的腳本
mcp-server-isitdown

# 使用 Python 模塊
python -m mcp_server_isitdown

示例使用 Claude Desktop

• "Wikipedia 現在是否離線？"
• "Reddit 最近一次 downtime 是何時？"

作為庫使用

from mcp_server_isitdown.server import get_website_status

# 檢查指定網站的在線狀態（異步函數）
async def check_website():
    result = await get_website_status("example.com")
    print(result)  # 打印狀態消息，包含在線/離線狀態信息

🔧 技術細節

工具詳情

• get_website_status：檢查指定網站是否當前在線或離線。
  • 輸入：root_domain (字符串)，要檢查的網站根域名（例如 "example.com"）
  • 輸出：一條消息，指示網站是正常運行還是離線，幷包含最近一次 downtime 的信息

開發相關

# 進行類型檢查
uvx mypy .

# 運行所有預提交鉤子
uv pre-commit run --all-files

# 在開發模式下安裝
uv pip install -e ".[dev]"

# 運行 Inspector
mcp dev src/mcp_server_isitdown/server.py

構建相關

# 構建包
uv build

# 安裝構建好的包
uv pip install dist/mcp_isitdown_service-*.whl

📄 許可證

本項目採用 MIT 許可證。