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 服务器
   • 类型：选择“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. 配置参数如上所述

环境变量

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

• PORT：指定服务器运行的端口（默认为 8000）
• DEBUG：启用调试模式（默认为 false）
• LOG_LEVEL：设置日志级别（ INFO、WARNING、ERROR，默认为 INFO）

注意事项

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