Web Content Retriever

🚀 MCP 服務端模板用於 Cursor IDE

這是一個簡單的模板，可藉助 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 服務器”
   • 點擊“添加新的 MCP 服務器”
   • 填寫表單：
     • 名稱：選擇任意名稱（例如，“my-mcp-server-1”）
     • 類型：選擇“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 運行 mcp-simple-tool

# 使用自定義端口上的 SSE 傳輸
uv 運行 --port=8000 mcp-simple-tool

# 關閉服務器
uv 停止

直接在 Cursor 中運行

如果要在 Cursor IDE 中直接運行此模板，請按照以下步驟操作：

1. 打開您的項目並安裝依賴項：

pip install -r requirements.txt

2. 啟動服務器：

uv 運行 mcp-simple-tool

🔧 技術細節

環境變量

您可以在 .env 文件中設置以下環境變量：

• PORT=8000：指定服務器的端口（默認為 8000）
• DEBUG=True：啟用調試模式

📚 詳細文檔

使用說明

此模板允許您快速創建和部署一個 MCP 服務器，用於與 Cursor IDE 進行交互。您可以根據需要修改 mcp-simple-tool.py 文件中的邏輯。

其他資源

• MCP 協議文檔
• Cursor IDE 官方文檔