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：

1. 打开 Cursor 设置
2. 转到 Features > MCP Servers
3. 单击 "+ Add New MCP Server"
4. 输入以下内容：
   • 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\"}"
    }
  ]
}

许可证

ISC 许可证