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 许可证