MCP Server Template for Cursor IDE
2025.02.08
33
PythonIDE扩展开发工具开发效率
example-mcp-server 是一个为 Cursor IDE 创建自定义工具的模板，基于 Model Context Protocol (MCP)。它允许开发者创建自己的工具库，并将其连接到 Cursor IDE 中。该服务器支持多种部署方式，包括 Docker、传统 Python 设置以及直接在 Cursor IDE 中运行。
View on GitHub
Overview
基本能力
产品定位
example-mcp-server 是一个为 Cursor IDE 提供自定义工具开发的模板，旨在通过 MCP 协议扩展 IDE 的功能。
核心功能
- 支持多种部署方式：Docker、传统 Python 设置、直接运行于 Cursor IDE
- 提供 SSE 和 stdio 两种传输方式
- 可自定义环境变量（如端口、主机、调试模式等）
- 支持通过 Smithery 自动安装
适用场景
- 为 Cursor IDE 开发自定义工具
- 扩展 IDE 功能
- 快速搭建 MCP 服务器原型
工具列表
cursor-run-mcp-server.sh：用于在 Cursor IDE 中直接运行 MCP 服务器的脚本- Docker Compose 配置：用于快速部署和运行服务器
- Smithery CLI：用于自动安装服务器
常见问题解答
- 如何连接服务器到 Cursor IDE？
- 打开 Cursor 设置 → 功能 → 添加新的 MCP 服务器
- 根据部署方式选择 SSE 或 stdio 类型
- 提供相应的 URL 或命令路径
使用教程
使用依赖
Docker 方式
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server
cp .env.example .env
传统 Python 方式
# 安装 uv 包管理器（macOS）
brew install uv
# 或通过 pip 安装（任何操作系统）
pip install uv
安装教程
Docker 方式
# 构建并启动服务器
docker compose up --build -d
# 查看日志
docker compose logs -f
# 检查服务器状态
docker compose ps
# 停止服务器
docker compose down
传统 Python 方式
# 安装带有开发依赖的包
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
调试方式
Docker 方式
# 测试服务器端点
curl -i http://localhost:8000/sse
传统 Python 方式
- 检查日志输出
- 使用
DEBUG=true环境变量启用调试模式 - 运行测试用例
uv run pytest -v