Ragie Model Context Protocol Server

A Model Context Protocol (MCP) server that provides access to Ragie's knowledge base retrieval capabilities.

Description

This server implements the Model Context Protocol to enable AI models to retrieve information from a Ragie knowledge base. It provides a single tool called "retrieve" that allows querying the knowledge base for relevant information.

Prerequisites

• Node.js >= 18
• A Ragie API key
• (Optional) A Ragie partition ID

Installation

The server requires the following environment variables:

• RAGIE_API_KEY (required): Your Ragie API authentication key
• RAGIE_PARTITION (optional): The Ragie partition ID to query

The server will start and listen on stdio for MCP protocol messages.

Install and run the server with npx:

RAGIE_API_KEY=your_api_key RAGIE_PARTITION=optional_partition_id npx @ragieai/mcp-server

Claude Desktop Configuration

To use this MCP server with Claude desktop:

1. Create the MCP config file claude_desktop_config.json:

• For MacOS: Open directory ~/Library/Application Support/Claude/ and create the file inside it
• For Windows: Open directory %APPDATA%/Claude/ and create the file inside it

2. Save claude_desktop_config.json with the following content:

• Note that RAGIE_PARTITION is optional.

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

Replace your_api_key with your actual Ragie API key and optionally set RAGIE_PARTITION if needed.

3. Restart Claude desktop for the changes to take effect.

The Ragie retrieval tool will now be available in your Claude desktop conversations.

Features

Retrieve Tool

The server provides a retrieve tool that can be used to search the knowledge base. It accepts the following parameters:

• query (string): The search query to find relevant information

The tool returns:

• An array of content chunks containing matching text from the knowledge base

Development

This project is written in TypeScript and uses the following main dependencies:

• @modelcontextprotocol/sdk: For implementing the MCP server
• ragie: For interacting with the Ragie API
• zod: For runtime type validation

Development setup

Running the server in dev mode:

RAGIE_API_KEY=your_api_key RAGIE_PARTITION=optional_partition_id npm run dev

Building the project:

npm run build

License

MIT License - See LICENSE.txt for details.