Huoshui Fetch

🚀 火水フェッチ

このサーバーは、ウェブページからのデータの取得、変換、抽出を行うためのツールを提供する、専用のウェブコンテンツ取得および変換MCP（モデルコンテキストプロトコル）サーバーです。

✨ 主な機能

取得ツール

• fetch_url：カスタマイズ可能なタイムアウト、リダイレクト処理、ユーザーエージェントを使用して、URLからコンテンツを取得します。
• fetch_with_headers：認証付きリクエストのために、カスタムヘッダーを使用してURLを取得します。

変換ツール

• html_to_markdown_tool：HTMLをきれいなMarkdown形式に変換します。
• html_to_text_tool：HTMLからプレーンテキストを抽出します。
• clean_html_tool：スクリプトやスタイルを削除し、HTMLをサニタイズします。
• json_to_markdown_tool：JSONデータを読みやすいMarkdownに変換します。

抽出ツール

• extract_article_tool：readabilityを使用して、メインの記事内容を抽出します。
• extract_links_tool：フィルタリングオプション付きで、すべてのリンクを抽出します。
• extract_metadata_tool：ページのメタデータ（タイトル、説明、OGタグ）を抽出します。
• extract_images_tool：サイズフィルタリング付きで、画像を抽出します。
• extract_structured_data_tool：JSON - LDやマイクロデータを抽出します。

📦 インストール

MCPレジストリから（推奨）

このサーバーは、モデルコンテキストプロトコルレジストリに登録されています。MCPクライアントを使用してインストールしてください。

mcp-name: io.github.huoshuiai42/huoshui-fetch

# uvを使用する（推奨）
uv sync

# またはGitHubからインストール
pip install git+https://github.com/yourusername/huoshui-fetch.git

💻 使用例

uvxで実行する（一度だけの使用に推奨）

# リポジトリから
uvx --from . huoshui-fetch

# GitHubから（公開されたら）
uvx --from git+https://github.com/yourusername/huoshui-fetch.git huoshui-fetch

直接実行する

# uvを使用する
uv run python -m huoshui_fetch

# またはインストールされている場合
python -m huoshui_fetch

このサーバーは、標準入出力を介して通信するため、Claude Desktopや他のMCP互換クライアントとの統合に最適です。

Claude Desktopの設定

Claude Desktopの設定に追加します。

{
  "mcpServers": {
    "huoshui-fetch": {
      "command": "uvx",
      "args": ["--no-cache", "--from", ".", "huoshui-fetch"],
      "cwd": "/path/to/huoshui-fetch"
    }
  }
}

またはGitHubからインストールした場合：

{
  "mcpServers": {
    "huoshui-fetch": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/yourusername/huoshui-fetch.git",
        "huoshui-fetch"
      ]
    }
  }
}

基本的な使用法

設定が完了したら、Claude Desktopでツールを使用できます。

# ウェブページを取得
fetch_url("https://example.com")

# HTMLをMarkdownに変換
html_to_markdown_tool("<h1>Hello</h1><p>World</p>")

# 記事内容を抽出
extract_article_tool(html_content, "https://example.com/article")

📚 詳細ドキュメント

必要条件

• Python 3.11以上
• pyproject.tomlに記載されている依存関係

開発と公開

このプロジェクトには、PyPIへのビルドと公開のための包括的な自動化機能が含まれています。

自動化された公開ワークフロー

# 完全自動化ワークフロー（TestPyPI + PyPI）
uv run python scripts/publish.py --include-pypi

# TestPyPIのみ（テストに推奨）
uv run python scripts/publish.py

# バージョンを更新して公開
uv run python scripts/publish.py --version-bump patch --include-pypi

個別のコマンド

# バージョン管理
uv run python scripts/version_manager.py --check
uv run python scripts/version_manager.py --bump patch

# PyPI資格情報を設定する（初回）
uv run python scripts/credentials_setup.py

# パッケージをビルドする
uv run python scripts/build.py

# 包括的なテストを実行する
uv run python scripts/test.py

# PyPIにアップロードする
uv run python scripts/upload.py

機能

• ✅ バージョン管理：すべてのファイル間で自動的に同期します。
• ✅ 品質チェック：Ruff lintingとMyPy型チェックを行います。
• ✅ ビルド自動化：検証付きのクリーンなビルドを行います。
• ✅ テストスイート：包括的なパッケージおよび機能テストを行います。
• ✅ 公開ワークフロー：uv publishを使用してTestPyPI → PyPI（.pypircファイルをサポート）。
• ✅ エラー回復：組み込みのエラーハンドリングと回復オプションがあります。

詳細なドキュメントはPUBLISHING.mdを参照してください。

DXT拡張機能

このプロジェクトは、簡単な配布とインストールのためにDXT（Desktop Extensions）形式をサポートしています。

DXT拡張機能をビルドするには：

python build_dxt.py

これにより、互換性のあるAIデスクトップアプリケーションにインストールできるhuoshui-fetch-{version}.dxtファイルが作成されます。

📄 ライセンス

MIT