Ragieai Ragie MCP Server

🚀 Ragie 模型上下文協議服務器

Ragie 模型上下文協議服務器實現了模型上下文協議（MCP），為 AI 模型提供從 Ragie 知識庫檢索信息的能力，讓信息獲取更高效。

🚀 快速開始

Ragie 模型上下文協議服務器實現了模型上下文協議，可使 AI 模型從 Ragie 知識庫中檢索信息。它提供了名為“retrieve”的單一工具，用於查詢知識庫獲取相關信息。

✨ 主要特性

• 實現模型上下文協議（MCP），賦予 AI 模型從 Ragie 知識庫檢索信息的能力。
• 提供“retrieve”工具，方便查詢知識庫。

📦 安裝指南

先決條件

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

環境變量

服務器需要以下環境變量：

• RAGIE_API_KEY（必需）：您的 Ragie API 認證密鑰

安裝命令

使用 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

💻 使用示例

光標配置

要將此 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",
        "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. 運行腳本：

./ragie-mcp.sh

🔧 技術細節

此項目使用 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。