Olostep Olostep MCP Server

🚀 Olostep MCP サーバー

Olostep に統合された Model Context Protocol (MCP) サーバーの実装で、ウェブクローリング、コンテンツ抽出、検索機能を提供します。

🚀 クイックスタート

Olostep MCP サーバーをセットアップするには、API キーが必要です。Olostep ウェブサイト で登録してキーを取得できます。

✨ 主な機能

• クリーンな Markdown 形式でウェブページのコンテンツを抽出
• Google 検索結果から構造化データを抽出
• ウェブサイトの URL を発見しマッピング
• 地理的なコンテンツのために、国/地域別のリクエストルーティングをサポート
• JavaScript が多用されたウェブサイトに対応するため、待機時間を設定可能
• 包括的なエラー処理とレポート
• シンプルな API キー設定

📦 インストール

npx を使用して実行

env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

手動インストール

npm install -g olostep-mcp

Claude Desktop で実行

以下の内容を claude_desktop_config.json ファイルに追加します：

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

または、Smithery CLI を使用してより直接的にインストールできます：

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Windsurf で実行

以下の内容を ./codeium/windsurf/model_config.json ファイルに追加します：

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor で実行

以下の内容を ~/.config/cursor ファイルに追加します：

npx olostep-mcp --set-global

環境変数

export OLOSTEP_API_KEY="your-api-key"

💻 使用例

基本的な使用法

ウェブページのコンテンツを取得

ターミナルから以下のコマンドでウェブページのコンテンツを取得します：

npx olostep-mcp get-content https://example.com

URL を抽出

対象ウェブサイトのすべてのリンクを抽出します：

npx olostep-mcp extract-urls https://example.com

検索機能

キーワードを検索して結果を取得します：

npx olostep-mcp search "your-query"

🔧 技術詳細

サーバーは強力なエラー処理機能を提供しており、詳細なエラーメッセージ、ネットワークエラーレポート、認証失敗処理、レート制限情報を含みます。

エラーレスポンスの例：

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API エラー：401 未承認。詳細情報：{\"error\":\"Invalid API key\"}"
    }
  ]
}

📄 ライセンス

ISC ライセンス