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

前提条件

  • 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 <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 サーバーを Cursor で使用するには:

オプション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 を設定します。

クロードデスクトップ構成

この 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",
        "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