by ragieai
Provides access to Ragie's knowledge base retrieval capabilities via the Model Context Protocol, enabling AI models to query and obtain relevant information.
Ragie Model Context Protocol Server enables AI models to retrieve relevant content from a Ragie knowledge base. It implements the Model Context Protocol and exposes a single retrieve tool that returns matching text chunks based on a query.
your_api_key):
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server
--description, -d <text> – custom tool description.--partition, -p <id> – specify a Ragie partition to query.mcp.json (or claude_desktop_config.json) that points to the npx @ragieai/mcp-server command and supplies the RAGIE_API_KEY environment variable.retrieve tool with parameters:
query (string, required)topK (number, default 8) – max results returnedrerank (boolean, default true) – prioritize relevancerecencyBias (boolean, default false) – favor newer content@modelcontextprotocol/sdk, ragie API client, and zod for validation.Q: Do I need to build the project before running it?
A: No. The server is distributed as an npm package and can be started directly with npx.
Q: Which environment variable supplies the API key?
A: RAGIE_API_KEY.
Q: Can I limit the number of returned results?
A: Yes, set the topK parameter when invoking the retrieve tool.
Q: How do I target a specific Ragie partition?
A: Use the --partition <id> (or -p <id>) CLI option.
Q: Is the server compatible with Cursor and Claude Desktop?
A: Yes. Add an mcp.json or claude_desktop_config.json file as described in the README, specifying the command, arguments, and RAGIE_API_KEY.
A Model Context Protocol (MCP) server that provides access to Ragie's knowledge base retrieval capabilities.
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.
The server requires the following environment variable:
RAGIE_API_KEY (required): Your Ragie API authentication keyThe server will start and listen on stdio for MCP protocol messages.
Install and run the server with npx:
RAGIE_API_KEY=your_api_key npx @ragieai/mcp-server
The server supports the following command line options:
--description, -d <text>: Override the default tool description with custom text--partition, -p <id>: Specify the Ragie partition ID to queryExamples:
# 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
To use this MCP server with Cursor:
mcp.json.cursor/mcp.json file in your project directory. This allows you to define MCP servers that are only available within that specific project.~/.cursor/mcp.json file in your home directory. This makes MCP servers available in all your Cursor workspaces.Example mcp.json:
{
"mcpServers": {
"ragie": {
"command": "npx",
"args": [
"-y",
"@ragieai/mcp-server",
"--partition",
"optional_partition_id"
],
"env": {
"RAGIE_API_KEY": "your_api_key"
}
}
}
}
ragie-mcp.sh on your system:#!/usr/bin/env bash
export RAGIE_API_KEY="your_api_key"
npx -y @ragieai/mcp-server --partition optional_partition_id
Give the file execute permissions: chmod +x ragie-mcp.sh
Add the MCP server script by going to Settings -> Cursor Settings -> MCP Servers in the Cursor UI.
Replace your_api_key with your actual Ragie API key and optionally set the partition ID if needed.
To use this MCP server with Claude desktop:
claude_desktop_config.json:~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%/Claude/claude_desktop_config.jsonExample claude_desktop_config.json:
{
"mcpServers": {
"ragie": {
"command": "npx",
"args": [
"-y",
"@ragieai/mcp-server",
"--partition",
"optional_partition_id"
],
"env": {
"RAGIE_API_KEY": "your_api_key"
}
}
}
}
Replace your_api_key with your actual Ragie API key and optionally set the partition ID if needed.
The Ragie retrieval tool will now be available in your Claude desktop conversations.
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 informationtopK (number, optional, default: 8): The maximum number of results to returnrerank (boolean, optional, default: true): Whether to try and find only the most relevant informationrecencyBias (boolean, optional, default: false): Whether to favor results towards more recent informationThe tool returns:
This project is written in TypeScript and uses the following main dependencies:
@modelcontextprotocol/sdk: For implementing the MCP serverragie: For interacting with the Ragie APIzod: For runtime type validationRunning the server in dev mode:
RAGIE_API_KEY=your_api_key npm run dev -- --partition optional_partition_id
Building the project:
npm run build
MIT License - See LICENSE.txt for details.
Please log in to share your review and rating for this MCP.
{
"mcpServers": {
"ragie": {
"command": "npx",
"args": [
"-y",
"@ragieai/mcp-server"
],
"env": {
"RAGIE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}claude mcp add ragie npx -y @ragieai/mcp-serverExplore related MCPs that share similar capabilities and solve comparable challenges
by modelcontextprotocol
A basic implementation of persistent memory using a local knowledge graph. This lets Claude remember information about the user across chats.
by topoteretes
Provides dynamic memory for AI agents through modular ECL (Extract, Cognify, Load) pipelines, enabling seamless integration with graph and vector stores using minimal code.
by basicmachines-co
Enables persistent, local‑first knowledge management by allowing LLMs to read and write Markdown files during natural conversations, building a traversable knowledge graph that stays under the user’s control.
by smithery-ai
Provides read and search capabilities for Markdown notes in an Obsidian vault for Claude Desktop and other MCP clients.
by chatmcp
Summarize chat messages by querying a local chat database and returning concise overviews.
by dmayboroda
Provides on‑premises conversational retrieval‑augmented generation (RAG) with configurable Docker containers, supporting fully local execution, ChatGPT‑based custom GPTs, and Anthropic Claude integration.
by qdrant
Provides a Model Context Protocol server that stores and retrieves semantic memories using Qdrant vector search, acting as a semantic memory layer.
by doobidoo
Provides a universal memory service with semantic search, intelligent memory triggers, OAuth‑enabled team collaboration, and multi‑client support for Claude Desktop, Claude Code, VS Code, Cursor and over a dozen AI applications.
by GreatScottyMac
Provides a project‑specific memory bank that stores decisions, progress, architecture, and custom data, exposing a structured knowledge graph via MCP for AI assistants and IDE tools.