Ragie模型上下文协议服务器

这是一个提供Ragie知识库检索功能的模型上下文协议(MCP)服务器。

描述

该服务器实现了模型上下文协议，使AI模型能够从Ragie知识库中检索信息。它提供了一个名为"retrieve"的单一工具，用于查询知识库中的相关信息。

前提条件

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

安装

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

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

服务器将启动并通过stdio监听MCP协议消息。

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

RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server

命令行选项

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

• --description, -d <文本>：用自定义文本覆盖默认工具描述
• --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配置

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

选项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",
        "可选分区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 可选分区ID

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

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

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

Claude桌面配置

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

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",
        "可选分区ID"
      ],
      "env": {
        "RAGIE_API_KEY": "your_api_key"
      }
    }
  }
}

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

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

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

功能

检索工具

服务器提供一个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 可选分区ID

构建项目：

npm run build

许可证

MIT许可证 - 详情请参阅LICENSE.txt。