【技术文档摘要】：

Ragie Model Context Protocol Server

这是一个实现Model Context Protocol的服务器，用于提供访问Ragie知识库检索能力的功能。

描述

此服务器实现了Model Context Protocol，使AI模型能够从Ragie知识库中检索信息。它提供了一个名为“retrieve”的工具，允许查询知识库以获取相关信息。

预备条件

• Node.js >= 18
• 一个Ragie API密钥

安装

服务器需要以下环境变量：

• RAGIE_API_KEY（必需）：您的Ragie API认证密钥

服务器启动后将在标准输入输出上监听MCP协议消息。

使用npx安装并运行服务器：

RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server

命令行选项

服务器支持以下命令行选项：

• --description, -d <text>：用自定义文本覆盖默认工具描述
• --partition, -p <id>：指定要查询的Ragie分区ID

示例：

# 使用自定义描述
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "搜索公司知识库中的信息"

# 指定分区
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --partition your_partition_id

# 同时使用两个选项
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "搜索公司知识库" --partition your_partition_id

Cursor配置

要与Cursor一起使用此MCP服务器：

选项1：创建一个MCP配置文件

1. 保存一个名为mcp.json的文件

• 对于特定于项目的工具，在项目目录中创建一个.cursor/mcp.json文件。这允许您定义仅在该特定项目中可用的MCP服务器。
• 对于您希望跨所有项目使用的工具，在您的主目录中创建一个~/.cursor/mcp.json文件。这使得MCP服务器可以在所有Cursor工作区中使用。

mcp.json示例：

{
  "mcpServers": {
    "ragie": {
      "command": "npx",
      "args": [
        "-y",
        "@ragieai/mcp-server",
        "--partition",
        "optional_partition_id"
      ],
      "env": {
        "RAGIE_API_KEY": "your_api_key"
      }
    }
  }
}

选项2：使用shell脚本

1. 在系统中保存一个名为ragie-mcp.sh的文件：

#!/usr/bin/env bash

export RAGIE_API_KEY="your_api_key"

npx -y @ragieai/mcp-server --partition optional_partition_id

2. 给文件执行权限：chmod +x ragie-mcp.sh

3. 通过进入设置 -> Cursor设置 -> MCP服务器在Cursor UI中添加MCP服务器脚本。

将your_api_key替换为您实际的Ragie API密钥，并根据需要设置分区ID。

Claude桌面配置

要与Claude桌面一起使用此MCP服务器：

1. 创建MCP配置文件claude_desktop_config.json：

• 对于MacOS：使用~/Library/Application Support/Claude/claude_desktop_config.json
• 对于Windows：使用%APPDATA%/Claude/claude_desktop_config.json

claude_desktop_config.json示例：

{
  "mcpServers": {
    "ragie": {
      "command": "npx",
      "args": [
        "-y",
        "@ragieai/mcp-server",
        "--partition",
        "optional_partition_id"
      ],
      "env": {
        "RAGIE_API_KEY": "your_api_key"
      }
    }
  }
}

将your_api_key替换为您实际的Ragie API密钥，并根据需要设置分区ID。

2. 重启Claude桌面以使更改生效。

现在，Ragie检索工具将在您的Claude桌面对话中可用。

功能

Retrieve工具

服务器提供了一个retrieve工具，可用于搜索知识库。它接受以下参数：

• query（字符串）：用于查找相关信息的搜索查询
• topK（数字，可选，默认值：8）：返回的最大结果数
• rerank（布尔值，可选，默认值：true）：是否尝试只找到最相关的信息
• recencyBias（布尔值，可选，默认值：false）：是否倾向于更近期的信息

该工具返回：

• 包含匹配文本的内容片段数组，这些内容来自知识库

开发

该项目使用TypeScript编写，并使用了以下主要依赖项：

• @modelcontextprotocol/sdk：用于实现MCP服务器
• ragie：用于与Ragie API交互
• zod：用于运行时类型验证

开发设置

在开发模式下运行服务器：

RAGIE_API_KEY=your_api_key npm run dev -- --partition optional_partition_id

构建项目：

npm run build

许可证

MIT许可证 - 详情见LICENSE.txt。