使用说明
Cursor IDE的MCP服务器模板
使用模型上下文协议（MCP）为Cursor IDE创建自定义工具的简单模板。使用此模板创建自己的存储库，修改工具，并将它们连接到您的Cursor IDE。
快速开始
-
点击“部署到Heroku”按钮
-
部署后，配置Cursor：
- 打开光标设置→ 特性
- 添加新的MCP服务器
- 使用您的Heroku URL
/sse路径（例如。，https://<your-app-name>.herokuapp.com/sse)
-
在Cursor中测试代理的情绪：
- 询问您的代理“请询问我们的服务器情绪，并告诉我情况如何。”
- 服务器将以愉快的消息和一颗心作为回应❤️
替代设置方法
您可以通过三种方式运行服务器：使用Docker、传统的Python设置或直接在Cursor IDE中运行。
Docker设置
该项目包括Docker支持，便于部署：
- 初始设置：
# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server
# Create environment file
cp .env.example .env
- 使用Docker Compose构建和运行：
# Build and start the server
docker compose up --build -d
# View logs
docker compose logs -f
# Check server status
docker compose ps
# Stop the server
docker compose down
-
服务器将在以下位置可用：
- SSE端点：http://localhost:8000/sse
-
快速测试：
# Test the server endpoint
curl -i http://localhost:8000/sse
- 连接到Cursor IDE：
- 打开光标设置→ 特性
- 添加新的MCP服务器
- 类型：选择“sse”
- URL:输入
http://localhost:8000/sse
传统设置
首先，安装uv包管理器：
# Install uv on macOS
brew install uv
# Or install via pip (any OS)
pip install uv
使用stdio（默认）或SSE传输启动服务器：
# Install the package with development dependencies
uv pip install -e ".[dev]"
# Using stdio transport (default)
uv run mcp-simple-tool
# Using SSE transport on custom port
uv run mcp-simple-tool --transport sse --port 8000
# Run tests
uv run pytest -v
安装后，您可以将服务器直接连接到Cursor IDE：
- 右键单击
cursor-run-mcp-server.sh游标中的文件 - 选择“复制路径”复制绝对路径
- 打开光标设置（齿轮图标）
- 导航到“功能”选项卡
- 向下滚动到“MCP服务器”
- 点击“添加新的MCP服务器”
- 填写表格：
- 名称：选择任何名称（例如，“my-mcp-server-1”）
- 类型：选择“stdio”（不是“sse”，因为我们在本地运行服务器）
- 命令：将绝对路径粘贴到
cursor-run-mcp-server.sh你之前复制的。例如：/Users/kirillmarkin/weaviate-mcp-server/cursor-run-mcp-server.sh
环境变量
可用环境变量（可在中设置 .env):
MCP_SERVER_PORT（默认值：8000）-运行服务器的端口MCP_SERVER_HOST（默认值：0.0.0.0）-将服务器绑定到的主机DEBUG（默认值：false）-启用调试模式MCP_USER_AGENT-用于网站获取的自定义用户代理
附加选项
通过Smithery安装
通过以下方式自动安装Claude Desktop Cursor IDE的MCP服务器模板 史密瑟里:
npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude
