MCP Server Template For Cursor IDE

🚀 使用Cursor IDE MCP 服務器模板創建自定義工具的簡單示例

本項目可藉助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 支持，以便於部署：

初始設置

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

# 創建環境文件
cp .env.example .env

構建並運行

# 構建並啟動服務器
docker compose up --build -d

# 查看日誌
docker compose logs -f

# 檢查服務器狀態
docker compose ps

# 停止服務器
docker compose down

訪問服務器

服務器將可通過以下地址訪問：

• SSE端點：http://localhost:8000/sse

快速測試

# 測試服務器端點
curl -i http://localhost:8000/sse

連接到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-simple-tool

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

# 運行測試
uv run pytest -v

連接到Cursor IDE

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

1. 右鍵點擊 cursor-run-mcp-server.sh 文件（位於Cursor中）
2. 選擇“複製路徑”以複製絕對路徑
3. 打開“Cursor設置”（齒輪圖標）
4. 轉到“功能”選項卡
5. 滾動到底部的“MCP服務器”
6. 點擊“添加新的MCP 代理”
7. 在“可執行文件”字段中粘貼複製的路徑

其他內容

環境變量

在 config.json 文件中，您可以指定以下環境變量：

快速開始示例

# 下載並運行容器
docker run -it --rm -p 8000:8000 -e PORT=8000 -e API_KEY=your_key here/wego

# 訪問控制面板
打開瀏覽器訪問 http://localhost:8000/admin

⚠️ 重要提示

請確保在生產環境中保護好您的API密鑰，並定期更新密碼以保證安全。

附加信息

使用Smithereen安裝服務器模板

你可以使用以下命令通過Smithereen安裝服務器模板：

smithereen install --template mcp-server-template

Glama服務器審查