关键词

Cursor IDEPrompt模板网页抓取开发工具代码生成

Simple Website Fetcher MCP服务器使用说明

项目简介

Simple Website Fetcher MCP服务器是一个基于Model Context Protocol (MCP) 的后端实现，它提供了一系列工具，包括网页内容抓取和Prompt模板应用。该服务器主要用于与支持MCP协议的客户端（如Cursor IDE）协同工作，扩展客户端的功能，例如可以辅助开发者快速获取网页信息，并根据不同的开发场景应用预设的Prompt模板，提高开发效率。

主要功能点

  • 网页抓取工具 (mcp_fetch): 允许客户端指定URL，服务器抓取该URL的网页内容并返回给客户端。
  • 心情检测工具 (mood): 一个简单的示例工具，用于演示工具调用的基本流程，返回服务器的心情状态。
  • Railway文档抓取工具 (fetch_railway_docs, fetch_railway_docs_optimized): 专门用于抓取Railway官方文档的内容，方便开发者查阅Railway CLI的使用方法。
  • Prompt模板应用工具 (apply_prompt_initial, apply_prompt_proceed, apply_prompt_change, apply_prompt_fix, apply_prompt_fix_linter, apply_prompt_unit_tests, apply_prompt_infra): 内置多种Prompt模板，涵盖了项目初始化、任务跟进、变更处理、缺陷修复、单元测试生成、基础设施配置等常见的开发场景，允许客户端根据需求选择合适的模板，并传入相应的参数，快速生成Prompt内容。

安装步骤

方式一：Heroku 快速部署 (推荐)

  1. 点击 README.md 中的 "Deploy to Heroku" 按钮，按照Heroku的指引完成部署。
  2. 部署完成后，您将获得一个Heroku的应用URL。

方式二：Docker 部署

  1. 确保您的机器已安装 Docker 和 Docker Compose。
  2. 克隆仓库到本地： 
    git clone https://github.com/jankowtf/mcp-hitchcode.git
cd mcp-hitchcode
  3. 复制 '.env.example' 文件并重命名为 '.env'，您可以根据需要修改 '.env' 文件中的环境变量（例如端口号）。
  4. 使用 Docker Compose 构建并运行服务器： 
    docker compose up --build -d
    服务器默认将在 'http://localhost:8000/sse' 提供 SSE 端点。

方式三：传统 Python 环境部署

  1. 确保您的机器已安装 Python 3.8+ 和 'uv' 包管理器（可以使用 'brew install uv' 或 'pip install uv' 安装 'uv'）。
  2. 克隆仓库到本地： 
    git clone https://github.com/jankowtf/mcp-hitchcode.git
cd mcp-hitchcode
  3. 安装项目依赖： 
    uv pip install -e ".[dev]"
  4. 启动服务器（默认使用 stdio 传输协议）： 
    uv run mcp-hitchcode
    或者使用 SSE 传输协议并指定端口： 
    uv run mcp-hitchcode --transport sse --port 8000

服务器配置 (MCP 客户端 - Cursor IDE)

要将此MCP服务器连接到 Cursor IDE，您需要在 Cursor IDE 的设置中添加新的 MCP 服务器。配置信息如下：

对于 SSE 传输 (Heroku 或 Docker 部署，或者使用 '--transport sse' 参数启动的传统 Python 环境部署):

{
  "serverName": "Simple Website Fetcher MCP Server",
  "type": "sse",
  "url": "http://your-server-address:8000/sse"  // 将 your-server-address 替换为您的服务器地址，例如 Heroku 应用的 URL 或 localhost:8000
}

对于 Stdio 传输 (默认传统 Python 环境部署):

{
  "serverName": "Simple Website Fetcher MCP Server",
  "type": "stdio",
  "command": "/path/to/mcp-hitchcode/cursor-run-mcp-server.sh", // 将 /path/to/mcp-hitchcode 替换为您本地仓库的绝对路径
  "args": [] // 启动参数，默认为空数组
}

注意:

  • 'command' 字段需要填写 'cursor-run-mcp-server.sh' 脚本的绝对路径。您可以通过在 Cursor IDE 中右键点击该文件并选择 "Copy Path" 来获取绝对路径。
  • 如果您修改了服务器的端口号或传输协议，请相应地修改 'url' 或启动参数。

基本使用方法

  1. 确保 MCP 服务器已成功启动并运行。
  2. 在 Cursor IDE 中配置并连接到您的 MCP 服务器。
  3. 在 Cursor IDE 中，您可以尝试以下操作来测试服务器的功能：
    • 询问服务器心情: 在 Cursor IDE 的聊天框中输入类似 "Please ask about our server mood and let me know how it is." 的问题，服务器应该会返回一个包含爱心符号的 cheerful message。
    • 使用网页抓取工具: 在 Cursor IDE 中，您可以指示 Agent 调用 'mcp_fetch' 工具并提供一个 URL，例如 "Fetch the content of https://www.example.com using the mcp_fetch tool."，服务器会将网页内容返回给 Agent。
    • 应用 Prompt 模板: 您可以指示 Agent 调用 'apply_prompt_initial' 等 Prompt 模板应用工具，并提供相应的参数（例如项目目标、任务描述等），服务器将返回根据模板生成的 Prompt 内容。

通过这些工具，您可以扩展 Cursor IDE 的能力，使其能够访问外部信息（网页内容）并利用预定义的Prompt模板来辅助您的开发工作。

信息

分类

网页与API

访问项目