Skip to main content
Glama
deenesjakoruzh
ragieai

Ragie Model Context Protocol Server

by ragieai
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

영상

Ragie 모델 컨텍스트 프로토콜 서버

Ragie의 지식 기반 검색 기능에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

설명

이 서버는 AI 모델이 Ragie 지식 기반에서 정보를 검색할 수 있도록 모델 컨텍스트 프로토콜을 구현합니다. "Retrieve"라는 단일 도구를 제공하여 지식 기반에서 관련 정보를 쿼리할 수 있습니다.

Related MCP server: RAG Information Retriever

필수 조건

  • 노드.js >= 18

  • Ragie API 키

설치

서버에는 다음 환경 변수가 필요합니다.

  • RAGIE_API_KEY (필수): Ragie API 인증 키

서버가 시작되어 stdio에서 MCP 프로토콜 메시지를 수신합니다.

npx로 서버를 설치하고 실행합니다.

지엑스피1

명령줄 옵션

서버는 다음 명령줄 옵션을 지원합니다.

  • --description, -d <text> : 기본 도구 설명을 사용자 정의 텍스트로 재정의합니다.

  • --partition, -p <id> : 쿼리할 Ragie 파티션 ID를 지정합니다.

예:

# With custom description
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "Search the company knowledge base for information"

# With partition specified
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --partition your_partition_id

# Using both options
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server --description "Search the company knowledge base" --partition your_partition_id

커서 구성

커서와 함께 이 MCP 서버를 사용하려면:

옵션 1: MCP 구성 파일 만들기

  1. mcp.json 이라는 파일을 저장합니다.

  • 특정 프로젝트에만 사용할 수 있는 도구의 경우 , 프로젝트 디렉터리에 .cursor/mcp.json 파일을 생성하세요. 이를 통해 해당 프로젝트 내에서만 사용할 수 있는 MCP 서버를 정의할 수 있습니다.

  • 모든 프로젝트에서 사용하려는 도구의 경우 , 홈 디렉터리에 ~/.cursor/mcp.json 파일을 만드세요. 이렇게 하면 모든 Cursor 작업 공간에서 MCP 서버를 사용할 수 있습니다.

예시 mcp.json :

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

옵션 2: 쉘 스크립트 사용

  1. ragie-mcp.sh 라는 파일을 시스템에 저장하세요.

#!/usr/bin/env bash

export RAGIE_API_KEY="your_api_key"

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

  1. 파일에 실행 권한을 부여하세요: chmod +x ragie-mcp.sh

  2. 커서 UI에서 설정 -> 커서 설정 -> MCP 서버 로 이동하여 MCP 서버 스크립트를 추가합니다.

your_api_key 실제 Ragie API 키로 바꾸고 필요한 경우 파티션 ID를 설정합니다.

클로드 데스크톱 구성

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를 설정합니다.

  1. 변경 사항을 적용하려면 Claude 데스크톱을 다시 시작하세요.

Ragie 검색 도구를 이제 Claude 데스크톱 대화에서 사용할 수 있습니다.

특징

검색 도구

이 서버는 지식 기반을 검색하는 데 사용할 수 있는 retrieve 도구를 제공합니다. 이 도구는 다음 매개변수를 허용합니다.

  • query (문자열): 관련 정보를 찾기 위한 검색 쿼리

도구는 다음을 반환합니다.

  • 지식 기반에서 일치하는 텍스트를 포함하는 콘텐츠 청크 배열

개발

이 프로젝트는 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를 참조하세요.

Available Tools

1 tool
retrieveA

Look up information in the Knowledge Base. Use this tool when you need to:

  • Find relevant documents or information on specific topics

  • Retrieve company policies, procedures, or guidelines

  • Access product specifications or technical documentation

  • Get contextual information to answer company-specific questions

  • Find historical data or information about projects

ParametersJSON Schema
NameRequiredDescriptionDefault
topKNoThe maximum number of results to return. Defaults to 8.
queryYesThe query to search for data in the Knowledge Base
filterNoThe metadata search filter on documents. Returns chunks only from documents which match the filter. The following filter operators are supported: $eq - Equal to (number, string, boolean), $ne - Not equal to (number, string, boolean), $gt - Greater than (number), $gte - Greater than or equal to (number), $lt - Less than (number), $lte - Less than or equal to (number), $in - In array (string or number), $nin - Not in array (string or number). The operators can be combined with AND and OR. Read Metadata & Filters guide for more details and examples.
rerankNoWhether to try and find only the most relevant data. Defaults to false.
recencyBiasNoWhether to favor data towards more recent documents. Defaults to false.

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full burden. It only implies a read-only operation by saying 'Look up information', but fails to explicitly state it is read-only, does not disclose authentication needs, rate limits, or error behavior. This is a significant gap for a retrieval tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is relatively concise, using a bullet list of use cases. It is front-loaded with the purpose statement. However, some redundancy exists with 'Use this tool when you need to' repeated for each item.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 5 parameters, including a complex nested filter object, and no output schema. The description does not explain the return format, pagination, or how results are structured. It only vaguely mentions 'information', leaving the agent without sufficient context to interpret the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and all parameters have descriptions in the schema. The tool description does not add additional meaning beyond what the schema provides. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Look up information in the Knowledge Base' and lists specific use cases (e.g., 'Find relevant documents', 'Retrieve company policies'). It directly addresses what the tool does with a specific verb and resource.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a bullet list of when to use the tool, such as 'Find relevant documents or information' and 'Get contextual information'. It implicitly guides usage but does not explicitly state when not to use or mention alternatives, though no sibling tools exist.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

B3.2/5.0
Disambiguation5/5

With only one tool, there is no potential for confusion between tools. The tool's purpose is clearly defined.

Naming Consistency3/5

With a single tool named 'retrieve', there is no pattern to evaluate. Naming is neither consistent nor inconsistent—it's neutral.

Tool Count1/5

A knowledge base server with only one retrieval tool is extremely minimal. Agents cannot perform any CRUD operations, making this count far too low for the implied scope.

Completeness1/5

The server only supports retrieval. Essential actions like adding, updating, or deleting documents are missing, leaving significant gaps in functionality.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Jilebi

    Datron
    A
    license
    Not graded
    quality
    B
    maintenance
    A plugin-based MCP server that enables AI assistants to interact with external systems through custom tools, resources, and prompts.
    4
    AGPL 3.0

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ragieai/ragie-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server