示例-MCP-服务器

Name: 示例-MCP-服务器
Author: kirill-markin

作者：kirill-markin36 星标更新：2025-02-08

安装使用来源：spider==github.com

项目介绍

使用Model Context Protocol (MCP)为Cursor IDE创建自定义工具的MCP服务器模板

这是一个简单的模板，用于使用Model Context Protocol (MCP)为Cursor IDE创建自定义工具。从这个模板创建自己的仓库，修改工具，并将其连接到你的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-simple-tool

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

# 运行测试
uv run pytest -v

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

在Cursor中右键点击cursor-run-mcp-server.sh文件
选择“复制路径”以复制绝对路径
打开Cursor设置（齿轮图标）
导航到功能标签页
向下滚动到“MCP服务器”
点击“添加新的MCP服务器”
填写表单：
- 名称：选择任意名称（例如：“my-mcp-server-1”）
- 类型：选择“stdio”（不是“sse”，因为我们本地运行服务器）
- 命令：粘贴你之前复制的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自动安装Cursor IDE的MCP服务器模板：

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

Glama服务器评论