Olostep MCP 服务器

一个与 Olostep 集成的模型上下文协议 (MCP) 服务器实现，用于网页抓取、内容提取和搜索功能。
要设置 Olostep MCP 服务器，您需要拥有一个 API 密钥。您可以通过在 Olostep 网站 上注册来获取 API 密钥。

功能

• 以干净的 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 上运行

要在 Cursor 中配置 Olostep MCP：

1. 打开 Cursor 设置
2. 转到 Features > MCP Servers
3. 点击 "+ Add New MCP Server"
4. 输入以下内容：
   • 名称: "olostep-mcp"（或您喜欢的名称）
   • 类型: "command"
   • 命令: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

将 your-api-key 替换为您的 Olostep API 密钥。

配置

环境变量

• OLOSTEP_API_KEY: 您的 Olostep API 密钥（必需）
• ORBIT_KEY: 用于通过 Orbit 路由请求的可选密钥。

可用工具

1. 获取网页内容 (get_webpage_content)

以干净的 Markdown 格式提取网页内容，并支持 JavaScript 渲染。

{
  "name": "get_webpage_content",
  "arguments": {
    "url_to_scrape": "https://example.com",
    "wait_before_scraping": 1000,
    "country": "US"
  }
}

参数：

• url_to_scrape: 要抓取的网页 URL（必需）
• wait_before_scraping: 抓取前等待的时间（以毫秒为单位，默认值：0）
• country: 请求的住宅国家（例如，US、CA、GB）（可选）

响应：

{
  "content": [
    {
      "type": "text",
      "text": "# 示例网站\n\n这是网页的 Markdown 内容..."
    }
  ]
}

2. 获取网站 URL (get_website_urls)

搜索并提取与查询相关的网站 URL，按相关性排序。

{
  "name": "get_website_urls",
  "arguments": {
    "url": "https://example.com",
    "search_query": "your search term"
  }
}

参数：

• url: 要映射的网站 URL（必需）
• search_query: 用于排序 URL 的搜索查询（必需）

响应：

{
  "content": [
    {
      "type": "text",
      "text": "找到 42 个与您的查询匹配的 URL：\n\nhttps://example.com/page1\nhttps://example.com/page2\n..."
    }
  ]
}

3. Google 搜索 (google_search)

从 Google 搜索结果中提取结构化数据。

{
  "name": "google_search",
  "arguments": {
    "query": "your search query",
    "country": "US"
  }
}

参数：

• query: 要执行的搜索查询（必需）
• country: 用于本地化结果的国家代码（例如，US、GB）（默认值："US"）

响应包括：

• 带有标题、链接和摘要的有机搜索结果
• 知识图谱数据（如果可用）
• 相关问题（People Also Ask）
• 相关搜索
• 富摘要和其他结构化数据

错误处理

服务器提供强大的错误处理功能：

• 详细的 API 错误消息
• 网络错误报告
• 认证失败处理
• 速率限制信息

示例错误响应：

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API 错误：401 未授权。详细信息：{\"error\":\"无效的 API 密钥\"}"
    }
  ]
}

许可证

ISC 许可证