MCP NPXフェッチ

Web コンテンツを簡単に取得し、さまざまな形式 (HTML、JSON、Markdown、プレーン テキスト) に変換するための強力な MCP サーバーです。

インストール•機能•使用方法•ドキュメント•貢献

🚀 機能

• 🌐ユニバーサルコンテンツフェッチ：HTML、JSON、プレーンテキスト、Markdown形式をサポート

• 🔒カスタムヘッダーのサポート: リクエストに認証とカスタムヘッダーを追加します

• 🛠組み込み変換：フォーマット間の自動変換

• ⚡高性能: 最新のJavaScript機能を搭載し、速度に最適化されています

• 🔌 MCP 互換: Claude Desktop やその他の MCP クライアントとシームレスに統合します

• 🎯型安全: 完全な型定義を備えたTypeScriptで記述されています

Related MCP server: MCP Server Fetch Python

📦 インストール

NPMグローバルインストール

npm install -g @tokenizin/mcp-npx-fetch

NPXによる直接使用

npx @tokenizin/mcp-npx-fetch

📚 ドキュメント

利用可能なツール

fetch_html

任意の URL から生の HTML コンテンツを取得して返します。

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_json

任意の URL から JSON データを取得して解析します。

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_txt

HTML タグとスクリプトを削除して、クリーンなプレーン テキスト コンテンツを取得して返します。

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_markdown

コンテンツを取得し、適切にフォーマットされた Markdown に変換します。

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

🔧 使用方法

CLI の使用法

MCP サーバーを直接起動します。

mcp-npx-fetch

またはnpx経由:

npx @tokenizin/mcp-npx-fetch

クロードデスクトップ統合

1. Claude Desktop 構成ファイルを見つけます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. mcpServersオブジェクトに次の構成を追加します。

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@tokenizin/mcp-npx-fetch"],
      "env": {}
    }
  }
}

💻 地域開発

1. リポジトリをクローンします。

git clone https://github.com/tokenizin-agency/mcp-npx-fetch.git
cd mcp-npx-fetch

2. 依存関係をインストールします:

npm install

3. 開発モードを開始します:

npm run dev

4. テストを実行します:

npm test

🛠 技術スタック

• モデルコンテキストプロトコル SDK - コア MCP 機能

• JSDOM - HTML の解析と操作

• Turndown - HTML から Markdown への変換

• TypeScript - 型安全性と最新のJavaScript機能

• Zod - ランタイム型検証

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更については、まずIssueを開いて、変更したい点について議論してください。

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/AmazingFeature ）

3. 変更をコミットします（ git commit -m 'Add some AmazingFeature' ）

4. ブランチにプッシュする ( git push origin feature/AmazingFeature )

5. プルリクエストを開く

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。