MCP Server Template for Cursor IDE

基本能力

产品定位

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

核心功能

1. 多种部署方式：支持Heroku、Docker和传统Python设置。
2. 与Cursor IDE集成：可以轻松将服务器连接到Cursor IDE，实现工具的无缝使用。
3. 环境变量配置：支持通过环境变量配置服务器端口、主机和调试模式等。
4. 测试功能：提供测试端点，方便开发者验证服务器状态。

适用场景

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

工具列表

1. Heroku部署工具：一键部署到Heroku平台。
2. Docker工具：支持通过Docker Compose快速构建和运行服务器。
3. 传统Python设置工具：支持通过uv包管理器安装和运行服务器。
4. Smithery安装工具：支持通过Smithery自动安装到Claude Desktop。

常见问题解答

1. 如何测试服务器状态？
2. 使用curl -i http://localhost:8000/sse命令测试服务器端点。
3. 如何连接到Cursor IDE？
4. 在Cursor设置中添加新的MCP服务器，选择类型（stdio或sse）并输入URL或命令路径。
5. 如何配置环境变量？
6. 在.env文件中设置MCP_SERVER_PORT、MCP_SERVER_HOST等变量。

使用教程

使用依赖

1. Docker依赖：
2. 安装Docker和Docker Compose。
3. 传统Python设置依赖：
4. 安装uv包管理器： bash brew install uv # macOS pip install uv # 任何OS

安装教程

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 # stdio传输 uv run mcp-simple-tool --transport sse --port 8000 # SSE传输

调试方式

1. 查看日志： bash docker compose logs -f
2. 检查服务器状态： bash docker compose ps
3. 停止服务器： bash docker compose down
4. 运行测试： bash uv run pytest -v

许可证

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