返回 MCP 目录
public公开dns本地运行

Weaviate MCP Server

一个为Cursor IDE创建自定义工具的MCP服务器模板,支持多种部署方式

article

README

🚀 使用Cursor IDE的MCP服务器模板

本模板可用于为Cursor IDE创建自定义工具,借助模型上下文协议(MCP)。在基于此模板创建个人仓库后,你能够对工具进行修改,并将其与你的Cursor IDE相连接。

服务器情绪响应

🚀 快速开始

  1. 点击“部署到Heroku”按钮: Deploy to 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
  1. 使用Docker Compose进行构建并运行:
# 构建并启动服务器
docker compose up --build -d

# 查看日志
docker compose logs -f

# 检查服务器状态
docker compose ps

# 停止服务器
docker compose down
  1. 服务器将通过以下地址提供服务:
    • SSE端点:http://localhost:8000/sse
  2. 快速测试:
# 测试服务器端点
curl -i http://localhost:8000/sse
  1. 连接到Cursor IDE:
    • 在Cursor中右键点击“cursor-run-mcp-server.sh”文件。
    • 选择“复制路径”以复制绝对路径。
    • 打开Cursor设置(齿轮图标)。
    • 转到“功能”标签。
    • 滚动到底部的“MCP服务器”。
    • 点击“添加新的MCP服务器”。
    • 输入以下信息:
      • 名称:Docker MCP Server
      • 类型:Custom
      • 命令:bash -c "cd /path/to/server && npm run dev"(根据实际路径调整)
      • 描述(可选):填入描述
    • 点击“完成”。

传统设置

  1. 克隆仓库:
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server
  1. 安装依赖项:
npm install
  1. 启动服务器:
npm run dev
  1. 连接到Cursor IDE:
    • 在Cursor中右键点击“cursor-run-mcp-server.sh”文件。
    • 选择“复制路径”以复制绝对路径。
    • 打开Cursor设置(齿轮图标)。
    • 转到“功能”标签。
    • 滚动到底部的“MCP服务器”。
    • 点击“添加新的MCP服务器”。
    • 输入以下信息:
      • 名称:Local MCP Server
      • 类型:Custom
      • 命令:bash -c "cd /path/to/server && npm run dev"(根据实际路径调整)
      • 描述(可选):填入描述
    • 点击“完成”。

环境变量

你可以在.env文件中定义以下环境变量:

  • PORT=3000:服务器运行的端口,默认为3000。
  • NODE_ENV=development:Node.js环境模式,可以设置为production

使用Smithery安装

如果你使用smithery,请运行以下命令:

# 安装smithery CLI
npm install -g @smithery/cli

# 在项目文件夹中初始化新的smithery服务
smithery init

# 添加并安装MCP服务器模板
smithery add mcp-server
smithery install

Glama 服务器审查

Server Template for Cursor IDE MCP server

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端