ragieai/mcp-server

*This project is no longer needed*. Ragie now supports MCP natively as a streamable HTTP server. See docs here: [https://docs.ragie.ai/docs/mcp-overview]
If you would like users within your company to be able to access you knowledge base in applications like Claude or ChatGPT, you may need MCP Bridge
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 : Override the default tool description with custom text
- --partition, -p : Specify the Ragie partition ID to query
Examples:
Cursor Configuration
To use this MCP server with Cursor:
Option 1: Create an MCP configuration file
1. 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
1. Save a file called ragie-mcp.sh on your system:
2. Give the file execute permissions: chmod +x ragie-mcp.sh
3. 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:
1. 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.
2. 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: