MCP Server Template For Cursor IDE

🚀 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 服務器
   • 類型：選擇“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-hitchcode

# 使用自定義端口的 SSE 傳輸
uv run mcp-hitchcode --transport sse --port 8000

# 運行測試
uv run pytest -v

安裝完成後，可以直接將服務器連接到 Cursor IDE：

1. 在 Cursor 中右鍵點擊“mcp-server”文件夾
2. 選擇“添加到.Cursor”
3. 配置參數如上所述

環境變量

以下是常用的環境變量及其含義：

📚 詳細文檔

注意事項

1. 確保所有環境變量正確配置
2. 測試服務器前，請先檢查依賴項是否安裝完成
3. 如果遇到問題，可以查看文檔或社區支持