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 官方文档