Example MCP Server

🚀 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 run mcp-simple-tool

# 使用 SSE 傳輸和自定義端口
uv run mcp-simple-tool --transport sse --port 8000

# 運行測試
uv run pytest -v

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

1. 右鍵點擊 Cursor 中的 cursor-run-mcp-server.py 文件。
2. 選擇“複製路徑”。
3. 打開終端並粘貼路徑。
4. 按下回車運行。

環境變量

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

• PORT=8000（默認端口）
• MCP_SERVER_NAME=server-name（服務器名稱）

💻 使用示例

基礎用法

# 克隆倉庫
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# 創建並激活 Python 虛擬環境
python -m venv venv
source venv/bin/activate

# 安裝依賴項
pip install -r requirements.txt

# 運行服務器
python cursor-run-mcp-server.py

📚 詳細文檔

項目地址

GitHub 倉庫