MCP 服务器模板用于 Cursor IDE

一个简单的模板，用于创建Cursor IDE 的自定义工具，使用模型上下文协议（MCP）。从该模板创建自己的仓库，修改工具并将其连接到您的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服务器”
   • 点击“添加新的MCP服务器”
   • 填写表单：
     • 名称：选择任意名称（例如，“my-mcp-server-1”）
     • 类型：选择“sse”
     • URL：输入http://localhost:8000/sse

传统设置

首先安装uv包管理器：

# 在macOS上安装
brew install uvtool/uvtool/uv

# 或者在其他系统上按照文档安装

然后运行以下命令：

uv app start --port 3000

环境变量

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

• PORT=3000：设置服务器端口
• API_KEY=your_api_key：配置API密钥
• DEBUG=true：启用调试模式
• MCP_USER_AGENT=custom-user-agent：设置网站抓取的自定义User-Agent

其他选项

使用GitHub Actions进行CI/CD：

您可以将此服务器集成到GitHub Actions中，实现自动构建和部署。

name: MCP Server CI/CD

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        action: actions/checkout@v3
      
      - name: Build with Docker
        run: docker-compose build --no-cache

      - name: Deploy to Heroku
        uses: heroku/heroku-action@v4
        with:
          command: compose

使用Docker Compose进行扩展

您可以使用以下命令将服务器部署到多个节点：

docker-compose up --scale 3

这样，您就可以拥有一个高可用性的MCP服务器集群。

注意事项

• 确保所有环境变量正确设置。
• 在生产环境中启用SSL以确保通信安全。
• 定期更新依赖项以保持最佳性能。