Olostep Olostep MCP Server

🚀 Olostep MCP 服務器

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 許可證