MCP 服务器

olostep-mcp

快速且经济高效地搜索谷歌、各个网站并抓取其内容。⚡️

README

Olostep MCP 服务器

一个模型上下文协议 (MCP) 服务器实现，它与 Olostep 集成，用于网页抓取、内容提取和搜索功能。要设置 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：

打开 Cursor 设置
转到 Features > MCP Servers
单击 "+ Add New MCP Server"
输入以下内容：
- Name: "olostep-mcp" (或您喜欢的名称)
- Type: "command"
- Command: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

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

配置

环境变量

OLOSTEP_API_KEY: 您的 Olostep API 密钥 (必需)

可用工具

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": "# Example Website\n\nThis is the markdown content of the webpage..."
    }
  ]
}

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": "Found 42 URLs matching your query:\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"）

响应包括：

包含标题、链接和摘要的自然搜索结果
可用时的知识图谱数据
相关问题（大家也在问）
相关搜索
丰富摘要和其他结构化数据

错误处理

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

API 问题的详细错误消息
网络错误报告
身份验证失败处理
速率限制信息

示例错误响应：

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}"
    }
  ]
}