MCP Server Template for Cursor IDE

基本能力

产品定位

MCP Server Template for Cursor IDE 是一个用于创建自定义工具的模板，旨在帮助开发者快速构建和集成工具到Cursor IDE中。

核心功能

1. 多种部署方式：支持Heroku、Docker和传统Python设置。
2. 与Cursor IDE集成：提供详细的集成指南，支持SSE和stdio两种传输方式。
3. 环境变量配置：支持通过环境变量配置服务器端口、主机和调试模式。
4. 测试工具：提供测试脚本和端点，方便开发者验证服务器状态。

适用场景

1. 开发工具扩展：为Cursor IDE开发自定义工具。
2. 快速原型开发：利用模板快速构建和测试新工具。
3. 团队协作：共享和部署自定义工具到团队环境中。

工具列表

1. Heroku部署工具：一键部署到Heroku平台。
2. Docker工具：支持Docker Compose快速部署和日志查看。
3. uv包管理器：用于安装和管理Python依赖。
4. 测试工具：包括curl测试和pytest测试框架。

常见问题解答

1. 如何测试服务器状态？
2. 使用curl -i http://localhost:8000/sse测试SSE端点。
3. 如何连接Cursor IDE？
4. 在Cursor Settings → Features中添加MCP服务器，选择SSE或stdio类型并输入URL或命令路径。
5. 如何配置环境变量？
6. 复制.env.example为.env并修改相应变量。

使用教程

使用依赖

1. Heroku部署：无需额外依赖，直接点击部署按钮。
2. Docker部署：需要安装Docker和Docker Compose。
3. 传统Python设置：需要安装uv包管理器。 bash # Install uv on macOS brew install uv # Or install via pip (any OS) pip install uv

安装教程

1. Heroku部署：
2. 点击"Deploy to Heroku"按钮，按照提示完成部署。
3. Docker部署： ```bash # 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

# 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 3. **传统Python设置**：bash # 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 ```

调试方式

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

许可证

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