🚀 MCP 服务器模板用于 Cursor IDE

这是一个简单的模板，可用于创建 Cursor IDE 的自定义工具，借助模型上下文协议（MCP）实现。您可以基于此模板创建自己的仓库，对工具进行修改，然后将其连接到您的 Cursor IDE。

🚀 快速开始

1. 点击“部署到 Heroku”按钮
2. 部署完成后，配置 Cursor：
   • 打开 Cursor 设置 → 功能
   • 添加新的 MCP 服务器
   • 使用您的 Heroku URL 和 /sse 路径（例如 https://<your-app-name>.herokuapp.com/sse）
3. 在 Cursor 中测试代理的情绪：
   • 询问您的代理“请告诉我我们的服务器情绪。”
   • 服务器会用愉快的信息和一个 ❤️ 回应

✨ 主要特性

该项目提供了一个简单模板，可用于创建 Cursor IDE 的自定义工具，利用模型上下文协议（MCP），支持多种部署和运行方式，包括通过 Heroku 部署、Docker 部署、传统 Python 设置，还能直接在 Cursor IDE 中运行。

📦 安装指南

您可以以三种方式运行服务器：使用 Docker、传统的 Python 设置，或直接在 Cursor IDE 中。

Docker 设置

该项目包含 Docker 支持，以便于部署：

1. 初始设置：

# 克隆仓库
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# 创建环境文件
cp .env.example .env

2. 使用 Docker Compose 构建并运行：

# 构建并启动服务器
docker compose up --build -d

# 查看日志
docker compose logs -f

# 检查服务器状态
docker compose ps

# 停止服务器
docker compose down

3. 服务器将可用在以下地址：
   • SSE 端点：http://localhost:8000/sse
4. 快速测试：

# 测试服务器端点
curl -i http://localhost:8000/sse

5. 连接到 Cursor IDE：
   • 打开 Cursor 设置 → 功能
   • 添加新的 MCP 服务器
   • 类型：选择“sse”
   • URL：输入 http://localhost:8000/sse

传统设置

首先安装 uv 包管理器：

# 在 macOS 上安装 uv
brew install uv
# 或在任何操作系统上使用 pip 安装
pip install uv

使用 stdio（默认）或 SSE 传输运行服务器：

# 安装包含开发依赖的包
uv pip install -e ".[dev]"

# 使用 stdio 传输
uv run main:app

# 使用 SSE 传输
uv run --sse main:app

环境变量

在 .env 文件中添加以下内容：

MCP_SERVER_PORT=5000
MCP_SERVER_NAME=example-server

📚 详细文档

• 完整的文档和示例可以在此处找到。
• 如果您有任何问题，请在GitHub Issues上提出。