🚀 MCP 服务器模板用于 Cursor IDE

这是一个简单的模板，可借助 Model Context Protocol (MCP) 在 Cursor IDE 里创建自定义工具。你能基于此模板创建自己的仓库，对工具进行修改，再将其连接到你的 Cursor IDE。

🚀 快速开始

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

✨ 主要特性

可通过三种方式运行服务器，分别是使用 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 服务器”。
   • 点击“添加新的 MCP 服务器”。
   • 填写表单：
     • 名称：选择任意名称（例如，“my-mcp-server-1”）。
     • 类型：选择“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 mcp-simple-tool

# 使用 SSE 传输和自定义端口
uv run mcp-simple-tool --transport sse --port 8000

# 运行测试
uv run pytest -v

安装完成后，可以直接将服务器连接到 Cursor IDE：

1. 右键点击 Cursor 中的 cursor-run-mcp-server.py 文件。
2. 选择“复制路径”。
3. 打开终端并粘贴路径。
4. 按下回车运行。

环境变量

可以在 .env 文件中设置以下环境变量：

• PORT=8000（默认端口）
• MCP_SERVER_NAME=server-name（服务器名称）

💻 使用示例

基础用法

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

# 创建并激活 Python 虚拟环境
python -m venv venv
source venv/bin/activate

# 安装依赖项
pip install -r requirements.txt

# 运行服务器
python cursor-run-mcp-server.py

📚 详细文档

项目地址

GitHub 仓库