article
README
🚀 使用Cursor IDE的MCP服务器模板
本模板可用于为Cursor IDE创建自定义工具,借助模型上下文协议(MCP)。在基于此模板创建个人仓库后,你能够对工具进行修改,并将其与你的Cursor IDE相连接。

🚀 快速开始
- 点击“部署到Heroku”按钮:
- 部署完成后,对Cursor进行配置:
- 打开“Cursor设置” → “功能”。
- 添加新的MCP服务器。
- 使用你的Heroku URL和
/sse路径(例如:https://<your-app-name>.herokuapp.com/sse)。
- 在Cursor中对代理的情绪进行测试:
- 向你的代理提问:“请告诉我我们的服务器情绪如何。”
- 服务器会以友好的信息和一个❤️作为响应。
📦 安装指南
你可以通过三种方式来运行该服务器,分别是使用Docker、传统的Python设置或者直接在Cursor IDE中运行。
Docker设置
本项目支持使用Docker进行便捷部署:
- 初始设置:
# 克隆仓库
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server
# 创建环境文件
cp .env.example .env
- 使用Docker Compose进行构建并运行:
# 构建并启动服务器
docker compose up --build -d
# 查看日志
docker compose logs -f
# 检查服务器状态
docker compose ps
# 停止服务器
docker compose down
- 服务器将通过以下地址提供服务:
- SSE端点:http://localhost:8000/sse
- 快速测试:
# 测试服务器端点
curl -i http://localhost:8000/sse
- 连接到Cursor IDE:
- 在Cursor中右键点击“cursor-run-mcp-server.sh”文件。
- 选择“复制路径”以复制绝对路径。
- 打开Cursor设置(齿轮图标)。
- 转到“功能”标签。
- 滚动到底部的“MCP服务器”。
- 点击“添加新的MCP服务器”。
- 输入以下信息:
- 名称:
Docker MCP Server - 类型:
Custom - 命令:
bash -c "cd /path/to/server && npm run dev"(根据实际路径调整) - 描述(可选):填入描述
- 名称:
- 点击“完成”。
传统设置
- 克隆仓库:
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server
- 安装依赖项:
npm install
- 启动服务器:
npm run dev
- 连接到Cursor IDE:
- 在Cursor中右键点击“cursor-run-mcp-server.sh”文件。
- 选择“复制路径”以复制绝对路径。
- 打开Cursor设置(齿轮图标)。
- 转到“功能”标签。
- 滚动到底部的“MCP服务器”。
- 点击“添加新的MCP服务器”。
- 输入以下信息:
- 名称:
Local MCP Server - 类型:
Custom - 命令:
bash -c "cd /path/to/server && npm run dev"(根据实际路径调整) - 描述(可选):填入描述
- 名称:
- 点击“完成”。
环境变量
你可以在.env文件中定义以下环境变量:
PORT=3000:服务器运行的端口,默认为3000。NODE_ENV=development:Node.js环境模式,可以设置为production。
使用Smithery安装
如果你使用smithery,请运行以下命令:
# 安装smithery CLI
npm install -g @smithery/cli
# 在项目文件夹中初始化新的smithery服务
smithery init
# 添加并安装MCP服务器模板
smithery add mcp-server
smithery install
微信扫一扫