使用说明

项目简介

Simple Website Fetcher 是一个 MCP (Model Context Protocol) 服务器的模板项目，旨在帮助开发者快速构建自定义工具，并集成到支持 MCP 协议的客户端，如 Cursor IDE。该服务器提供两个简单的工具：一个是网页内容抓取工具，可以获取指定 URL 的网页文本内容；另一个是心情查询工具，用于演示服务器的基本交互能力。

主要功能点

网页内容抓取 (mcp_fetch): 输入 URL，返回网页的文本内容，使 LLM 可以获取和利用网络信息。
心情查询 (mood): 一个简单的示例工具，用于测试服务器连接和交互，总是返回积极友好的心情回复。
支持多种部署方式: 可以通过 Docker 快速部署，也可以使用传统的 Python 环境运行，还可以在 Heroku 等平台部署。
支持 Stdio 和 SSE 传输协议: 灵活适配不同的客户端连接需求。

安装步骤

你可以选择以下任一方式安装和运行 MCP 服务器：

方法一：使用 Docker (推荐，快速部署)

克隆仓库: 在你的本地计算机上克隆 GitHub 仓库：

git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

启动 Docker 容器: 使用 Docker Compose 启动服务器：
```
docker compose up --build -d
```
服务器将通过 SSE 协议在 'http://localhost:8000/sse' 提供服务。

方法二：传统 Python 环境 (适合本地开发和调试)

安装 uv (或使用 pip): 如果尚未安装，请先安装 uv 包管理器 (推荐) 或 pip：

# 使用 Homebrew 安装 uv (macOS):
brew install uv
# 或使用 pip 安装 (所有操作系统):
pip install uv

安装项目依赖: 使用 uv 或 pip 安装项目依赖和开发依赖：

uv pip install -e ".[dev]"
# 或
pip install -e ".[dev]"

运行服务器: 使用 uv 运行服务器，可以选择 stdio 或 SSE 传输协议。

使用 stdio 传输 (默认):

uv run mcp-simple-tool

使用 SSE 传输 (指定端口 8000):

uv run mcp-simple-tool --transport sse --port 8000

服务器配置 (MCP 客户端配置)

以下是在 MCP 客户端 (例如 Cursor IDE) 中配置 Simple Website Fetcher MCP 服务器的步骤和配置信息。

对于 SSE 传输 (Docker 部署或 Python SSE 模式):

在 Cursor IDE 的 MCP 服务器设置中，添加新的服务器，并填写以下信息：

服务器名称 (Server Name): 'Simple Website Fetcher' (可以自定义)
类型 (Type): 'sse'
URL: 'http://localhost:8000/sse' (如果使用 Docker 或 Python SSE 模式默认端口运行在本地) 或你的 Heroku 部署 URL 加上 '/sse' 路径。

配置 JSON 示例 (无需手动填写，仅供参考，Cursor IDE 图形界面配置即可):

{
  "serverName": "Simple Website Fetcher",
  "type": "sse",
  "url": "http://localhost:8000/sse"
}

对于 Stdio 传输 (Python Stdio 模式):