Token导航 LogoToken导航TokenDH.com
ReviewWebsite MCP Server logo
AI代理未说明官方级别未说明来源级核验

ReviewWebsite MCP Server

MCP Server

一个基于Model Context Protocol (MCP)的服务器,用于连接AI助手与ReviewWebsite.com API,实现网站评论的创建、管理、数据提取及URL转Markdown等功能。

工具数

0

提示词数

0

GitHub Stars

7

资源数

0
数据提取TypeScriptMarkdown转换

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

mrgoonie

提供方

mrgoonie

最后核验

2026/5/17 20:20

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

查看Website.com-MCP服务器

该项目提供了一个模型上下文协议(MCP)服务器,将AI助手连接到 浏览网站 API用于创建和管理网站评论、提取数据、将URL转换为降价等。

可用特征

  • \[x\] 创建、阅读、更新和删除网站评论
  • \[x\] 获取可用的AI模型
  • \[x\] 使用AI将URL转换为Markdown
  • \[x\] 使用AI从URL中提取结构化数据
  • \[x\] 抓取URL并提取内容
  • \[x\] 从网站中提取链接
  • \[x\] 使用AI总结网址和网站
  • \[x\] SEO见解(关键词创意、关键词难度、流量分析、反向链接)
  • \[x\] 自定义AI模型和参数
  • \[x\] 控制等待行为和时间

查看Web.site

支持的交通工具

- \[\]使用以下命令实现auth(“Authorization”标头 Bearer )

如何使用

命令行界面

# Get available AI models
npm run dev:cli -- get-ai-models --api-key "your-api-key"

# Create a new review
npm run dev:cli -- create-review --url "https://example.com" --instructions "Review this website" --api-key "your-api-key"

# Get a specific review by ID
npm run dev:cli -- get-review --review-id "review-id" --api-key "your-api-key"

# List all reviews
npm run dev:cli -- list-reviews --page 1 --limit 10 --api-key "your-api-key"

# Update a review
npm run dev:cli -- update-review --review-id "review-id" --url "https://example.com" --instructions "Updated instructions" --api-key "your-api-key"

# Delete a review
npm run dev:cli -- delete-review --review-id "review-id" --api-key "your-api-key"

# Convert URL to Markdown
npm run dev:cli -- convert-to-markdown --url "https://example.com" --model "gpt-4o" --api-key "your-api-key"

# Extract structured data from URL
npm run dev:cli -- extract-data --url "https://example.com" --instructions "Extract product information" --api-key "your-api-key"

# Scrape URL
npm run dev:cli -- scrape-url --url "https://example.com" --api-key "your-api-key"

# Extract links from URL
npm run dev:cli -- extract-links --url "https://example.com" --type "all" --api-key "your-api-key"

# Summarize URL
npm run dev:cli -- summarize-url --url "https://example.com" --model "gpt-4o" --api-key "your-api-key"

# Get keyword ideas for SEO
npm run dev:cli -- seo-keyword-ideas --keyword "digital marketing" --country "us" --search-engine "Google" --api-key "your-api-key"

# Check keyword difficulty
npm run dev:cli -- seo-keyword-difficulty --keyword "digital marketing" --country "us" --api-key "your-api-key"

# Analyze website traffic
npm run dev:cli -- seo-traffic --domain-or-url "example.com" --mode "subdomains" --country "us" --api-key "your-api-key"

# Get backlinks for a domain
npm run dev:cli -- seo-backlinks --domain "example.com" --api-key "your-api-key"

MCP设置

对于使用stdio传输的本地配置:

{
  "mcpServers": {
    "reviewwebsite": {
      "command": "node",
      "args": ["/path/to/reviewwebsite-mcp-server/dist/index.js"],
      "transportType": "stdio"
    }
  }
}

对于远程HTTP配置:

{
  "mcpServers": {
    "reviewwebsite": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

HTTP传输的环境变量:

您可以使用以下环境变量配置HTTP服务器:

  • MCP_HTTP_HOST:要绑定的主机(默认值: 127.0.0.1)
  • MCP_HTTP_PORT:要侦听的端口(默认值: 8080)
  • MCP_HTTP_PATH:端点路径(默认值: /mcp)

______________________________________________________________________

源代码概述

什么是MCP?

模型上下文协议(MCP)是一个开放标准,允许人工智能系统安全地与外部工具和数据源进行上下文连接。

该样板文件采用一种干净、分层的体系结构来实现MCP规范,该体系结构可以扩展为为任何API或数据源构建自定义MCP服务器。

为什么要使用这个锅炉板?

  • 生产就绪架构:遵循已发布的MCP服务器中使用的相同模式,CLI、工具、控制器和服务之间有明确的分离。
  • 类型安全:使用TypeScript构建,以改善开发人员体验、代码质量和可维护性。
  • 工作示例:包括一个完全实现的IP查找工具,演示了从CLI到API集成的完整模式。
  • 测试框架:配备用于单元和CLI集成测试的测试基础设施,包括覆盖率报告。
  • 开发工具:包括ESLint、Prettier、TypeScript和其他为MCP服务器开发预配置的质量工具。

______________________________________________________________________

入门指南

先决条件

  • Node.js (>=18.x): 下载
  • Git:用于版本控制

______________________________________________________________________

步骤1:克隆并安装

# Clone the repository
git clone https://github.com/mrgoonie/reviewwebsite-mcp-server.git
cd reviewwebsite-mcp-server

# Install dependencies
npm install

______________________________________________________________________

步骤2:运行开发服务器

在开发模式下使用stdio传输启动服务器(默认):

npm run dev:server

或者使用流式HTTP传输:

npm run dev:server:http

这将通过热重新加载启动MCP服务器,并在以下位置启用MCP检查器http://localhost:5173.

⚙️ 代理服务器侦听端口6277 🔍 MCP检查器已启动并运行http://127.0.0.1:6274

使用HTTP传输时,服务器将在http://127.0.0.1:8080/mcp默认情况下。

______________________________________________________________________

步骤3:测试ReviewWebsite API工具

通过CLI使用ReviewWebsite API工具:

# Get available AI models
npm run dev:cli -- get-ai-models --api-key "your-api-key"

# Create a review
npm run dev:cli -- create-review --url "https://example.com" --instructions "Review this website" --api-key "your-api-key"

# Convert URL to Markdown
npm run dev:cli -- convert-to-markdown --url "https://example.com" --model "gpt-4o" --api-key "your-api-key"

______________________________________________________________________

建筑

这个样板遵循一个干净的、分层的架构模式,该模式分离了关注点并提高了可维护性。

项目结构

src/
├── cli/              # Command-line interfaces
├── controllers/      # Business logic
├── resources/        # MCP resources: expose data and content from your servers to LLMs
├── services/         # External API interactions
├── tools/            # MCP tool definitions
├── types/            # Type definitions
├── utils/            # Shared utilities
└── index.ts          # Entry point

层次和责任

CLI层(src/cli/*.cli.ts)

  • 目的:定义解析参数和调用控制器的命令行界面
  • 命名:文件应命名 .cli.ts
  • 测试:中的CLI集成测试 .cli.test.ts

工具层(src/tools/*.tool.ts)

  • 目的:为人工智能助手定义带有模式和描述的MCP工具
  • 命名:文件应命名 .tool.ts 类型在 .types.ts
  • 模式:每个工具都应该使用zod进行参数验证

控制器层(src/controllers/*.controller.ts)

  • 目的:实现业务逻辑、处理错误和格式化响应
  • 命名:文件应命名 .controller.ts
  • 模式:应返回标准化 ControllerResponse 物体

服务层(src/services/*.service.ts)

  • 目的:与外部API或数据源交互
  • 命名:文件应命名 .service.ts
  • 模式:具有最小逻辑的纯API交互

工具 层src/utils/*.util.ts)

  • 目的:在整个应用程序中提供共享功能
  • 关键实用程序:

- logger.util.ts:结构化日志记录 - error.util.ts:错误处理和标准化 - formatter.util.ts:Markdown格式助手

______________________________________________________________________

开发指南

开发脚本

# Start server in development mode (hot-reload & inspector)
npm run dev:server

# Run CLI in development mode
npm run dev:cli -- [command] [args]

# Build the project
npm run build

# Start server in production mode
npm run start:server

# Run CLI in production mode
npm run start:cli -- [command] [args]

测试

# Run all tests
npm test

# Run specific tests
npm test -- src/path/to/test.ts

# Generate test coverage report
npm run test:coverage

代码质量

# Lint code
npm run lint

# Format code with Prettier
npm run format

# Check types
npm run typecheck

______________________________________________________________________

构建自定义工具

按照以下步骤将您自己的工具添加到服务器:

1.定义服务层

在中创建新服务 src/services/ 与外部API交互:

// src/services/example.service.ts
import { Logger } from '../utils/logger.util.js';

const logger = Logger.forContext('services/example.service.ts');

export async function getData(param: string): Promise {
	logger.debug('Getting data', { param });
	// API interaction code here
	return { result: 'example data' };
}

2.创建控制器

在中添加控制器 src/controllers/ 处理业务逻辑:

// src/controllers/example.controller.ts
import { Logger } from '../utils/logger.util.js';
import * as exampleService from '../services/example.service.js';
import { formatMarkdown } from '../utils/formatter.util.js';
import { handleControllerError } from '../utils/error-handler.util.js';
import { ControllerResponse } from '../types/common.types.js';

const logger = Logger.forContext('controllers/example.controller.ts');

export interface GetDataOptions {
	param?: string;
}

export async function getData(
	options: GetDataOptions = {},
): Promise {
	try {
		logger.debug('Getting data with options', options);

		const data = await exampleService.getData(options.param || 'default');

		const content = formatMarkdown(data);

		return { content };
	} catch (error) {
		throw handleControllerError(error, {
			entityType: 'ExampleData',
			operation: 'getData',
			source: 'controllers/example.controller.ts',
		});
	}
}

3.实施MCP工具

在中创建工具定义 src/tools/:

// src/tools/example.tool.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import { Logger } from '../utils/logger.util.js';
import { formatErrorForMcpTool } from '../utils/error.util.js';
import * as exampleController from '../controllers/example.controller.js';

const logger = Logger.forContext('tools/example.tool.ts');

const GetDataArgs = z.object({
	param: z.string().optional().describe('Optional parameter'),
});

type GetDataArgsType = z.infer;

async function handleGetData(args: GetDataArgsType) {
	try {
		logger.debug('Tool get_data called', args);

		const result = await exampleController.getData({
			param: args.param,
		});

		return {
			content: [{ type: 'text' as const, text: result.content }],
		};
	} catch (error) {
		logger.error('Tool get_data failed', error);
		return formatErrorForMcpTool(error);
	}
}

export function register(server: McpServer) {
	server.tool(
		'get_data',
		`Gets data from the example API, optionally using \`param\`.
Use this to fetch example data. Returns formatted data as Markdown.`,
		GetDataArgs.shape,
		handleGetData,
	);
}

4.添加CLI支持

在中创建CLI命令 src/cli/:

// src/cli/example.cli.ts
import { program } from 'commander';
import { Logger } from '../utils/logger.util.js';
import * as exampleController from '../controllers/example.controller.js';
import { handleCliError } from '../utils/error-handler.util.js';

const logger = Logger.forContext('cli/example.cli.ts');

program
	.command('get-data')
	.description('Get example data')
	.option('--param ', 'Optional parameter')
	.action(async (options) => {
		try {
			logger.debug('CLI get-data called', options);

			const result = await exampleController.getData({
				param: options.param,
			});

			console.log(result.content);
		} catch (error) {
			handleCliError(error);
		}
	});

5.注册组件

更新入口点以注册新组件:

// In src/cli/index.ts
import '../cli/example.cli.js';

// In src/index.ts (for the tool)
import exampleTool from './tools/example.tool.js';
// Then in registerTools function:
exampleTool.register(server);

______________________________________________________________________

调试工具

MCP检查员

访问可视化MCP检查器以测试您的工具并查看请求/响应详细信息:

  1. npm run dev:server
  2. 打开http://localhost:5173在您的浏览器中
  3. 测试您的工具并直接在UI中查看日志

服务器日志

启用开发调试日志:

# Set environment variable
DEBUG=true npm run dev:server

# Or configure in ~/.mcp/configs.json

______________________________________________________________________

发布您的MCP服务器

准备发布自定义MCP服务器时:

  1. 用您的详细信息更新package.json
  2. 使用您的工具文档更新README.md
  3. 构建项目: npm run build
  4. 测试生产版本: npm run start:server
  5. 发布到npm: npm publish

______________________________________________________________________

许可证

MIT许可证

{
	"reviewwebsite": {
		"environments": {
			"DEBUG": "true",
			"REVIEWWEBSITE_API_KEY": "your-api-key-here"
		}
	}
}

注: 为了向后兼容,服务器还将识别完整包名称下的配置(reviewwebsite-mcp-server)或未作用域的包名称(reviewwebsite-mcp-server)如果 reviewwebsite 找不到密钥。然而,使用短 reviewwebsite 建议将密钥用于新配置。

目录标签

目录标签

数据提取TypeScriptMarkdown转换AI助手集成本地部署网站评论管理SEO分析

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

token

部署方式(deploymentType,部署类型)

remote-capable

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明tokenremote-capable

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP