使用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 支持，以便于部署：

1. 初始设置：

# 克隆存储库
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# 创建环境文件
cp .env.example .env

2. 使用Docker Compose构建并运行：

# 构建并启动服务器
docker compose up --build -d

# 查看日志
docker compose logs -f

# 检查服务器状态
docker compose ps

# 停止服务器
docker compose down

3. 服务器将可通过以下地址访问：

   • SSE端点：http://localhost:8000/sse

4. 快速测试：

# 测试服务器端点
curl -i http://localhost:8000/sse

5. 将服务器连接到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 中连接服务器：

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

其他内容

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

  • PORT：设置服务器端口，默认为80
  • API_KEY：设置用于身份验证的密钥
  • DEBUG：启用调试模式（true 或 false）

• 快速开始示例：

# 下载并运行容器
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服务器审查

以上是所有内容的完整中文翻译，确保了信息的准确性和完整性。