Ragie

Ragie

MCP server providing access to Ragie's knowledge base retrieval capabilities.

82
Stars
19
Forks
1
Releases

Overview

The Ragie MCP Server is a Model Context Protocol (MCP) server that enables AI models to retrieve information from Ragie's knowledge base. It implements MCP and exposes a single tool, retrieve, which can be invoked by models to query Ragie's knowledge store for relevant content. The server is a Node.js/TypeScript application that requires Node.js 18 or newer and a Ragie API key (RAGIE_API_KEY) to authenticate with Ragie's API. It runs as an MCP endpoint over standard I/O, listening for protocol messages on stdin and returning results via stdout. The project uses @modelcontextprotocol/sdk for MCP integration, the ragie client to fetch knowledge items, and zod for runtime type validation. Usage involves setting RAGIE_API_KEY and running with npx @ragieai/mcp-server, with optional --partition to restrict queries and --description to override the tool description. The retrieve tool accepts query (string), topK (number, default 8), rerank (boolean, default true), and recencyBias (boolean, default false), returning an array of content chunks that match the query. The README also describes integration options for Cursor and Claude Desktop configurations.

Details

Owner
ragieai
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Retrieve Tool

Exposes a tool named retrieve to search Ragie's knowledge base. Parameters: query (string), topK (default 8), rerank (default true), recencyBias (default false). Returns an array of matching content chunks.

MCP protocol over stdio

The server communicates using the Model Context Protocol via standard input/output.

CLI-based customization

Allows overriding the tool description with --description and selecting a Ragie partition with --partition.

Ragie API key authentication

Requires the RAGIE_API_KEY environment variable for Ragie API authentication.

Partition-aware queries

Supports querying a specific Ragie partition via the --partition option.

Cursor integration

Configurable through mcp.json files (project-specific or user-wide) to load Ragie MCP servers in Cursor workflow.

Claude Desktop integration

Configurable via claude_desktop_config.json to expose the Ragie MCP server in Claude Desktop.

TypeScript with SDK and validation

Written in TypeScript and uses @modelcontextprotocol/sdk and zod for runtime validation.

Tags

RagieMCPknowledge baseretrieveCursorClaude DesktopRAGIE_API_KEYNode.jsTypeScriptSDKZodpartition