MCP Server Template For Cursor IDE

🚀 MCP 服务器模板用于 Cursor IDE

这是一个简单的模板，可用于在 Cursor IDE 中借助 Model Context Protocol (MCP) 创建自定义工具。你可以基于此模板创建自己的仓库，对工具进行修改，然后将其连接到你的 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 服务器
   • 类型：选择“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-hitchcode

# 使用自定义端口的 SSE 传输
uv run mcp-hitchcode --transport sse --port 8000

# 运行测试
uv run pytest -v

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

1. 在 Cursor 中右键点击“mcp-server”文件夹
2. 选择“添加到.Cursor”
3. 配置参数如上所述

环境变量

以下是常用的环境变量及其含义：

📚 详细文档

注意事项

⚠️ 重要提示

1. 确保所有环境变量正确配置
2. 测试服务器前，请先检查依赖项是否安装完成
3. 如果遇到问题，可以查看文档或社区支持