这是一个基于 Model Context Protocol (MCP) 的服务器,旨在连接 AI 助手与 ReviewWebsite.com 的 API。它使得 AI 能够方便地执行与网页相关的任务,例如获取网页信息、进行内容分析、提取结构化数据以及执行总结等。

主要功能点

  • 网页内容转换: 将指定网页的内容转换为 Markdown 格式。
  • 数据提取: 利用AI从网页中提取结构化数据,可根据用户提供的指令和JSON模板进行。
  • 网页抓取与链接提取: 获取网页的原始内容,并能从中提取各种类型的链接(网页、图片、文件等)。
  • 内容总结: 使用AI对单个网页或整个网站的内容进行摘要总结。
  • 支持配置AI模型和参数,控制加载延迟等。

安装步骤

  1. 确保您已安装 Node.js (版本 >=18.x) 和 Git
  2. 克隆项目仓库:
    git clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git
    cd reviewwebsite-mcp-server
  3. 安装项目依赖:
    npm install

服务器配置

MCP服务器用于与MCP客户端(如某些AI或代理应用)通信。要让您的MCP客户端使用此服务器,您需要在客户端的配置中添加服务器信息。通常是在一个 JSON 文件 (如 '~/.mcp/configs.json') 的 'mcpServers' 部分添加配置。以下是配置示例,请根据您的实际安装路径和服务运行方式进行调整:

// ~/.mcp/configs.json 或您的MCP客户端指定的配置文件
{
  "mcpServers": {
    "reviewwebsite": { // 为这个MCP服务器指定一个名称
      "command": "node", // 启动服务器的可执行命令
      "args": [ // 传递给命令的参数
        "/path/to/your/reviewwebsite-mcp-server/dist/index.js" // 指向服务器主入口文件,请替换为实际路径
      ],
      "transportType": "stdio" // 使用标准输入输出流进行通信 (适用于CLI或本地启动)
      // 或者使用HTTP传输 (适用于网络服务):
      // "type": "http",
      // "url": "http://localhost:8080/mcp" // MCP服务器监听的地址,请替换为实际地址
    }
  }
  // 您可能还需要在此处配置 ReviewWebsite API 密钥,具体取决于您的 MCP 客户端如何处理敏感信息
  // 例如,如果客户端支持环境配置:
  // "reviewwebsite": {
  //   "environments": {
  //     "REVIEWWEBSITE_API_KEY": "your-api-key-here" // 您的 ReviewWebsite API 密钥,请替换
  //   }
  // }
}

> 注意: 请将 '/path/to/your/reviewwebsite-mcp-server/dist/index.js' 替换为您实际安装项目的路径。ReviewWebsite API 密钥是使用这些功能所必需的,您可以在 reviewweb.site/profile 获取。密钥可以通过客户端配置的环境变量或直接在工具调用中传递。

基本使用方法

配置完成后,您的MCP客户端应该能够发现并调用 ReviewWebsite MCP 服务器提供的工具。以下是一些通过命令行模拟客户端调用的示例 (假设您在项目目录下运行,且已安装依赖):

  • 将网页转换为 Markdown:
    # 这取决于您的MCP客户端如何调用工具,这是一个概念示例
    # 实际命令会由您的MCP客户端提供
    your-mcp-client tool call reviewwebsite.convert_to_markdown '{"url": "https://example.com", "api_key": "your-api-key"}'
    或者如果客户端从配置读取API key:
    your-mcp-client tool call reviewwebsite.convert_to_markdown '{"url": "https://example.com"}'
  • 从网页提取数据:
    your-mcp-client tool call reviewwebsite.extract_data '{"url": "https://example.com/product/123", "instructions": "Extract product name and price", "jsonTemplate": "{ \\"name\\": \\"\\", \\"price\\": 0 }", "api_key": "your-api-key"}'
  • 总结网页内容:
    your-mcp-client tool call reviewwebsite.summarize_url '{"url": "https://example.com/blog/post", "model": "gpt-4o", "api_key": "your-api-key"}'

> 提示: 上述 'your-mcp-client tool call' 是一个概念性的示例,实际调用方式完全取决于您使用的 MCP 客户端软件。请查阅您MCP客户端的文档以了解正确的工具调用格式。

信息

分类

网页与API