Meilisearch Ts MCP

Meilisearch MCP服务器

](https://smithery.ai/server/@devlimelabs/meilisearch-ts-mcp)

Meilisearch的模型上下文协议（MCP）服务器实现，使AI助手能够通过标准化的接口与Meilisearc进行交互。

特性

• 索引管理：创建、更新和删除索引
• 文档管理：添加、更新和删除文档
• 搜索功能：使用各种参数和过滤器进行搜索
• 设置管理：配置索引设置
• 任务管理：监视和管理异步任务
• 系统操作：健康检查、版本信息和统计信息
• 矢量搜索：实验性矢量搜索功能

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版Meilisearch MCP服务器 史密瑟里:

npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude

手动安装

1. 克隆存储库：

   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git
   cd meilisearch-ts-mcp

1. 安装依赖项：

   npm install

1. 创建一个 .env 基于示例的文件：

   cp .env.example .env

1. 编辑 .env 文件来配置您的Meilisarch连接。

Docker设置

Meilisearch MCP服务器可以在Docker容器中运行，以便于部署和隔离。

使用Docker Compose

开始使用Docker的最简单方法是使用Docker Compose：

# Start the Meilisearch MCP Server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the server
docker-compose down

手动构建和运行Docker镜像

您还可以手动构建和运行Docker镜像：

# Build the Docker image
docker build -t meilisearch-ts-mcp .

# Run the container
docker run -p 3000:3000 --env-file .env meilisearch-ts-mcp

开发设置

对于希望为Meilisearch MCP服务器做出贡献的开发人员，我们提供了一个方便的设置脚本：

# Clone the repository
git clone https://github.com/devlimelabs-ts-mcp/meilisearch-ts-mcp.git
cd meilisearch-ts-mcp

# Run the development setup script
./scripts/setup-dev.sh

安装脚本将：

1. 创建一个 .env 文件来自 .env.example 如果它不存在
2. 安装依赖项
3. 构建项目
4. 运行测试以确保一切正常工作

运行安装脚本后，您可以在开发模式下启动服务器：

npm run dev

用法

建设项目

npm run build

运行服务器

npm start

发展模式

npm run dev

Claude桌面集成

Meilisearch MCP服务器可以与Claude for Desktop集成，允许您直接通过Claude与Meiliseach实例进行交互。

自动设置

我们提供了一个设置脚本，可以自动配置Claude for Desktop与Meilisearch MCP服务器一起工作：

# First build the project
npm run build

# Then run the setup script
node scripts/claude-desktop-setup.js

脚本将：

1. 检测您的操作系统并找到Claude for Desktop配置文件
2. 从以下位置读取您的Meilisearch配置 .env 文件
3. 为Claude for Desktop生成必要的配置
4. 提供更新Claude for Desktop配置的说明

手动设置

如果您更喜欢手动配置Claude for Desktop：

1. 找到您的Claude for Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加以下配置（根据需要调整路径）：

{
  "mcpServers": {
    "meilisearch": {
      "command": "node",
      "args": ["/path/to/meilisearch-ts-mcp/dist/index.js"],
      "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

1. 重新启动Claude for Desktop以应用更改。

1. 在Claude中，键入：“我想使用Meilisearch MCP服务器”以激活集成。

光标集成

Meilisearch MCP服务器也可以与 光标，一个AI驱动的代码编辑器。

在游标中设置MCP

1. 安装并设置Meilisearch MCP服务器：

   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git
   cd meilisearch-ts-mcp
   npm install
   npm run build

1. 启动MCP服务器：

   npm start

1. 在光标中，打开命令面板（Cmd/Ctrl+Shift+P）并搜索“MCP:连接到MCP服务器”。

1. 选择“连接到本地MCP服务器”并输入以下详细信息：

- 名字：Meilisearch - 命令：节点 - 参数：/advolute/path/to/meilisearch ts mcp/dist/index.js - 环境变量:

     MEILISEARCH_HOST=http://localhost:7700
     MEILISEARCH_API_KEY=your-api-key

1. 点击“连接”以建立连接。

1. 现在，您可以通过输入“在我的Meilisarch索引中搜索关于…的文档”等命令，通过Cursor与您的Meilisearch实例进行交互

可用工具

Meilisearch MCP服务器提供以下工具：

索引工具

• create-index：创建新索引
• get-index：获取有关索引的信息
• list-indexes：列出所有索引
• update-index：更新索引
• delete-index：删除索引

文档工具

• add-documents：将文档添加到索引中
• get-document：通过ID获取文档
• get-documents：获取多个文档
• update-documents：更新文档
• delete-document：按ID删除文档
• delete-documents：删除多个文档
• delete-all-documents：删除索引中的所有文档

搜索工具

• search：搜索文档
• multi-search：在单个请求中执行多个搜索

设置工具

• get-settings：获取索引设置
• update-settings：更新索引设置
• reset-settings：将索引设置重置为默认值
• 各种特定的设置工具（同义词、停用词、排名规则等）

任务工具

• list-tasks：列出具有可选筛选的任务
• get-task：获取特定任务的信息
• cancel-tasks：根据提供的筛选器取消任务
• wait-for-task：等待特定任务完成

系统工具

• health：检查Meilisearch服务器的运行状况
• version：获取版本信息
• info：获取系统信息
• stats：获取有关索引的统计信息

矢量工具（实验）

• enable-vector-search：启用矢量搜索
• get-experimental-features：获取实验功能状态
• update-embedders：配置嵌入器
• get-embedders：获取嵌入器配置
• reset-embedders：重置嵌入器配置
• vector-search：执行矢量搜索

许可证

麻省理工学院