JinDaGe - MCP Server Template for Cursor IDE MCP Details

article

README

🚀 MCP 服务器模板用于 Cursor IDE

这是一个简单的模板，可用于在 Cursor IDE 中借助 Model Context Protocol (MCP) 创建自定义工具。你可以基于此模板创建自己的仓库，对工具进行修改，然后将其连接到你的 Cursor IDE。

服务器情绪响应

🚀 快速开始

点击“部署到 Heroku”按钮
部署完成后，配置 Cursor：
- 打开“Cursor 设置” → “功能”
- 添加新的 MCP 服务器
- 使用你的 Heroku URL 加上 /sse 路径（例如：https://<your-app-name>.herokuapp.com/sse）
在 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 构建并运行：

# 构建并启动服务器
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-hitchcode

# 使用自定义端口的 SSE 传输
uv run mcp-hitchcode --transport sse --port 8000

# 运行测试
uv run pytest -v

安装完成后，可以直接将服务器连接到 Cursor IDE：

在 Cursor 中右键点击“mcp-server”文件夹
选择“添加到.Cursor”
配置参数如上所述

环境变量

以下是常用的环境变量及其含义： | 属性 | 详情 | |------|------| | PORT | 指定服务器运行的端口（默认为 8000） | | DEBUG | 启用调试模式（默认为 false） | | LOG_LEVEL | 设置日志级别（ INFO、WARNING、ERROR，默认为 INFO） |

📚 详细文档

注意事项

⚠️ 重要提示

确保所有环境变量正确配置

测试服务器前，请先检查依赖项是否安装完成

如果遇到问题，可以查看文档或社区支持

MCP Server Template for Cursor IDE