用于 Cursor IDE 的 MCP 服务器模板

一个使用模型上下文协议 (MCP) 为 Cursor IDE 创建自定义工具的简单模板。从此模板创建您自己的存储库，修改工具，并将它们连接到您的 Cursor IDE。

快速开始

1. 点击 "Deploy to Heroku" 按钮

   

2. 部署后，配置 Cursor：

   • 打开 Cursor 设置 → Features
   • 添加新的 MCP 服务器
   • 使用您的 Heroku URL，并加上 /sse 路径 (例如，https://<your-app-name>.herokuapp.com/sse)

3. 在 Cursor 中测试您的代理的心情：

   • 询问您的代理 "Please ask about our server mood and let me know how it is." (请询问我们服务器的心情，并告诉我它的状态。)
   • 服务器将回复一条欢快的消息和一个爱心 ❤️

其他设置方法

您可以通过三种方式运行服务器：使用 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 设置 → Features
   • 添加新的 MCP 服务器
   • Type: 选择 "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 中右键单击 cursor-run-mcp-server.sh 文件
2. 选择 "Copy Path" 以复制绝对路径
3. 打开 Cursor 设置 (齿轮图标)
4. 导航到 Features 选项卡
5. 向下滚动到 "MCP Servers"
6. 点击 "Add new MCP server"
7. 填写表格：
   • Name: 选择任何名称 (例如，"my-mcp-server-1")
   • Type: 选择 "stdio" (不是 "sse"，因为我们在本地运行服务器)
   • Command: 粘贴您之前复制的 cursor-run-mcp-server.sh 的绝对路径。例如：/Users/kirillmarkin/weaviate-mcp-server/cursor-run-mcp-server.sh

环境变量

可用的环境变量 (可以在 .env 中设置)：

• MCP_SERVER_PORT (默认: 8000) - 服务器运行的端口
• MCP_SERVER_HOST (默认: 0.0.0.0) - 服务器绑定的主机
• DEBUG (默认: false) - 启用调试模式
• MCP_USER_AGENT - 用于网站抓取的自定义 User-Agent

其他选项

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Cursor IDE 的 MCP 服务器模板：

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Glama 服务器评论

<a href="https://glama.ai/mcp/servers/jgisqn8zco"><img width="380" height="200" src="https://glama.ai/mcp/servers/jgisqn8zco/badge" alt="Server Template for Cursor IDE MCP server" /></a>