URL验证服务

URL验证器

一个使用Express、TypeScript、Playwright和OpenAI构建的MCP服务器应用程序，用于验证URL。该服务对URL进行全面检查，涉及浏览器交互和人工智能分析。

先决条件

• Node.js（建议使用v18.x或更高版本）
• npm（通常随Node.js一起提供）

地方发展设置

1. 克隆存储库：

   复制

   git clone <repository-url>
   cd url-validator
   

   （替换 <repository-url> 使用存储库的实际URL）

2. 安装依赖项： 此命令安装中定义的所有必需的Node.js包 package.json.

   复制

   npm install
   

3. 安装Playwright浏览器： Playwright需要浏览器二进制文件才能运行。此命令将下载它们。

   复制

   npx playwright install
   

4. 创建一个 .env 文件： 此项目使用OpenAI API密钥。创建一个名为的文件 .env 在项目的根目录中，并添加您的API密钥：

   复制

   OPENAI_API_KEY=your_openai_api_key_here
   

   重要提示：确保 .env 已列在您的 .gitignore 文件以防止提交敏感密钥。

5. 构建项目： 将TypeScript代码编译成JavaScript，它将被放置在 dist 目录。

   复制

   npm run build
   

运行应用程序

为了发展

此命令使用 ts-node 直接从以下位置运行TypeScript服务器 src 目录。这通常与支持热重新加载的工具一起使用，以获得更好的开发体验。

npm run dev

服务器通常会在默认端口（例如4000，或应用程序配置中指定的端口）上启动。检查控制台输出的确切端口。

用于生产

首先，确保项目已建成(npm run build).此命令从运行服务器的编译JavaScript版本 dist 目录。

npm start

项目结构

• src/：包含TypeScript源代码。
  • server.ts：可能是Express服务器的主要入口点。
• dist/：包含编译的JavaScript代码（输出 npm run build).
• package.json：定义项目元数据、依赖关系和脚本。
• tsconfig.json：TypeScript编译器配置。
• .env：（由您创建）用于环境变量，如API键。
• .gitignore：指定Git应忽略的有意未跟踪的文件。
• .gitpod.yml：Gitpod（基于云的开发环境）的配置。
• setup.sh：此脚本用于MCP（模型上下文协议）配置单元入职，而不是用于一般的本地项目设置。

MCP蜂巢板载

这 setup.sh 该脚本是专门为将此项目与MCP配置单元环境集成而设计的。它处理该平台所需的依赖关系、Playwright浏览器和项目构建步骤。对于本地开发，请按照上述“本地开发设置”说明进行操作。