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