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
Installation
The server requires the following environment variable:
RAGIE_API_KEY
(required): Your Ragie API authentication key
The server will start and listen on stdio for MCP protocol messages.
Install and run the server with npx:
Command Line Options
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 query
Examples:
Cursor Configuration
To use this MCP server with Cursor:
Option 1: Create an MCP configuration file
- Save a file called
mcp.json
- For tools specific to a project, create a
.cursor/mcp.json
file in your project directory. This allows you to define MCP servers that are only available within that specific project. - For tools that you want to use across all projects, create a
~/.cursor/mcp.json
file in your home directory. This makes MCP servers available in all your Cursor workspaces.
Example mcp.json
:
Option 2: Use a shell script
- Save a file called
ragie-mcp.sh
on your system:
- 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.
Claude Desktop Configuration
To use this MCP server with Claude desktop:
- Create the MCP config file
claude_desktop_config.json
:
- For MacOS: Use
~/Library/Application Support/Claude/claude_desktop_config.json
- For Windows: Use
%APPDATA%/Claude/claude_desktop_config.json
Example claude_desktop_config.json
:
Replace your_api_key
with your actual Ragie API key and optionally set the partition ID if needed.
- 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 serverragie
: For interacting with the Ragie APIzod
: For runtime type validation
Development setup
Running the server in dev mode:
Building the project:
License
MIT License - See LICENSE.txt for details.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that enables AI models to retrieve information from Ragie's knowledge base through a simple 'retrieve' tool.
- Description
- Prerequisites
- Installation
- Cursor Configuration
- Claude Desktop Configuration
- Features
- Development
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server integrating Perplexity AI's API to offer advanced search capabilities with support for multiple models and result configuration.Last updated -11JavaScriptMIT License
- -securityAlicense-qualityAn MCP server implementation that enables AI models to discover, search, and analyze data stored in Typesense collections through tools for querying documents, retrieving specific items, and accessing collection statistics.Last updated -217TypeScriptMIT License
- -securityAlicense-qualityAn MCP server that allows AI assistants to interact with Foundry datasets, ontology objects, and functions through natural language queries and commands.Last updated -2PythonMIT License
- -security-license-qualityAn MCP server that enables AI assistants to access up-to-date documentation for Python libraries like LangChain, LlamaIndex, and OpenAI through dynamic fetching from official sources.Last updated -1PythonMIT License