Simple Tool (Website Fetcher)

🚀 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 中測試代理的情緒：

   • 詢問你的代理“請告訴我我們服務器的情緒。”
   • 服務器將用愉快的消息回覆，並附上一個 ❤️。

✨ 主要特性

該項目支持三種運行服務器的方式，還可集成到 GitHub Actions 實現 CI/CD，以及使用 Docker Compose 進行擴展。

📦 安裝指南

替代設置方法

你可以使用三種方式運行該服務器：使用 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 以確保通信安全。
• 定期更新依賴項以保持最佳性能。