MCP Server Template For Cursor IDE

🚀 使用Cursor IDE MCP 服务器模板创建自定义工具的简单示例

本项目可借助Model Context Protocol（MCP）为Cursor IDE创建一个简单模板，用于构建自定义工具。你可以基于该模板创建自己的存储库，对工具进行修改，再将其连接到你的Cursor IDE。

🚀 快速开始

1. 点击“使用Heroku部署”按钮：

   

2. 部署完成后，配置Cursor：

   • 打开“Cursor设置” → “功能”
   • 添加新的MCP服务器
   • 使用您的Heroku URL 和 /sse 路径（例如：https://<your-app-name>.herokuapp.com/sse）

3. 在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 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设置” → “功能”
• 添加新的MCP 服务器
• 类型：选择“sse”
• URL：输入 http://localhost:8000/sse

传统设置

安装uv包管理器

# 在macOS 上安装uv
brew install uv
# 或者使用pip（任何操作系统）
pip install uv

启动服务器

使用stdio（默认）或 SSE 传输启动服务器：

# 安装包含开发依赖项的包
uv pip install -e ".[dev]"

# 使用 stdio 传输（默认）
uv run mcp-simple-tool

# 使用自定义端口上的SSE 传输
uv run mcp-simple-tool --transport sse --port 8000

# 运行测试
uv run pytest -v

连接到Cursor IDE

安装完成后，可以直接在Cursor IDE 中连接服务器：

1. 右键点击 cursor-run-mcp-server.sh 文件（位于Cursor中）
2. 选择“复制路径”以复制绝对路径
3. 打开“Cursor设置”（齿轮图标）
4. 转到“功能”选项卡
5. 滚动到底部的“MCP服务器”
6. 点击“添加新的MCP 代理”
7. 在“可执行文件”字段中粘贴复制的路径

其他内容

环境变量

在 config.json 文件中，您可以指定以下环境变量：

快速开始示例

# 下载并运行容器
docker run -it --rm -p 8000:8000 -e PORT=8000 -e API_KEY=your_key here/wego

# 访问控制面板
打开浏览器访问 http://localhost:8000/admin

⚠️ 重要提示

请确保在生产环境中保护好您的API密钥，并定期更新密码以保证安全。

附加信息

使用Smithereen安装服务器模板

你可以使用以下命令通过Smithereen安装服务器模板：

smithereen install --template mcp-server-template

Glama服务器审查