mcp-server-isitdown

🚀 mcp-server-isitdown

mcp-server-isitdown 是一个 MCP 服务器，可通过查询 www.isitdownrightnow.com 来检查网站当前是否离线，为用户提供网站状态信息。

🚀 快速开始

此 MCP 服务器提供了一个简单的工具，用于检查网站是否处于离线状态，并可以获取最近的 downtime 事件信息。

✨ 主要特性

• 实现了 get_website_status 工具，可检查指定网站是否当前在线或离线。
  • 输入：root_domain (字符串)，要检查的网站根域名（例如 "example.com"）。
  • 输出：一条消息，指示网站是正常运行还是离线，并包含最近一次 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)  # 打印状态消息，包含在线/离线状态信息

🔧 技术细节

开发

# 进行类型检查
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 许可证。