MCP Server Template for Cursor IDE

基本能力

产品定位

MCP Server Template 是一个用于 Cursor IDE 的 MCP 服务器模板，帮助开发者快速创建和部署自定义工具。

核心功能

1. 提供多种部署方式：Heroku、Docker、传统 Python 设置和直接运行在 Cursor IDE 中
2. 支持两种传输协议：stdio 和 SSE
3. 包含测试功能，可检查服务器状态
4. 提供环境变量配置选项

适用场景

1. 为 Cursor IDE 开发自定义工具
2. 快速搭建 MCP 服务器原型
3. 测试和调试 MCP 协议实现

工具列表

1. cursor-run-mcp-server.sh - 用于在 Cursor IDE 中直接运行 MCP 服务器的脚本
2. Docker 相关工具 - 用于容器化部署
3. uv 包管理器 - 用于 Python 依赖管理

常见问题解答

1. 如何连接服务器到 Cursor IDE？
2. 在 Cursor 设置中添加 MCP 服务器，根据部署方式选择 stdio 或 SSE 类型
3. 如何测试服务器是否正常运行？
4. 使用 curl 命令测试 SSE 端点或检查日志
5. 如何更改服务器端口？
6. 通过设置 MCP_SERVER_PORT 环境变量

使用教程

使用依赖

1. 对于 Docker 部署：
2. 需要安装 Docker 和 Docker Compose
3. 对于传统 Python 设置：
4. 需要安装 uv 包管理器 bash # macOS brew install uv # 其他系统 pip install uv

安装教程

1. Docker 安装方式： bash git clone https://github.com/kirill-markin/weaviate-mcp-server.git cd weaviate-mcp-server cp .env.example .env docker compose up --build -d
2. 传统 Python 安装方式： bash uv pip install -e ". [dev]" uv run mcp-simple-tool

调试方式

1. 查看 Docker 日志： bash docker compose logs -f
2. 测试 SSE 端点： bash curl -i http://localhost:8000/sse
3. 运行测试： bash uv run pytest -v

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。