MCP Template

🚀 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 中測試代理的情緒：
   • 詢問您的代理“請告訴我我們的服務器情緒。”
   • 服務器會用愉快的信息和一個 ❤️ 回應

✨ 主要特性

該項目提供了一個簡單模板，可用於創建 Cursor IDE 的自定義工具，利用模型上下文協議（MCP），支持多種部署和運行方式，包括通過 Heroku 部署、Docker 部署、傳統 Python 設置，還能直接在 Cursor IDE 中運行。

📦 安裝指南

您可以以三種方式運行服務器：使用 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 main:app

# 使用 SSE 傳輸
uv run --sse main:app

環境變量

在 .env 文件中添加以下內容：

MCP_SERVER_PORT=5000
MCP_SERVER_NAME=example-server

📚 詳細文檔

• 完整的文檔和示例可以在此處找到。
• 如果您有任何問題，請在GitHub Issues上提出。