MCP NPX Fetch

MCP NPX Fetch

---

🚀 機能

• 🌐 あらゆるコンテンツの取得：HTML、JSON、プレーンテキスト、Markdown 形式に対応
• 🔒 カスタムヘッダー対応：リクエストに認証情報やカスタムヘッダーを追加できます
• 🛠 変換機能を内蔵：形式間の自動変換
• ⚡ 高いパフォーマンス：最新の JavaScript 機能を使用し、速度を最適化
• 🔌 MCP 対応：Claude Desktop やその他の MCP クライアントとシームレスに連携
• 🎯 型安全：TypeScript で記述され、完全な型定義を備えています

📦 インストール

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

Claude Desktop との連携

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

🛠 技術スタック

• Model Context Protocol 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 の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

---