Moorcheh MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Moorcheh's Embedding, Vector Store, Search, and Gen AI Answer services. This server enables you to interact with Moorcheh's comprehensive AI capabilities including document embedding, vector storage, semantic search, and AI-powered answer generation through the Model Context Protocol.

There are two ways to use the Moorcheh MCP server:

The easiest way to get started:

# Set your API key and run directly
MOORCHEH_API_KEY=your_api_key_here npx -y @moorchehai/mcp

If you prefer to clone and run locally:

1. Clone the repository

   git clone https://github.com/moorcheh-ai/moorcheh-mcp.git
   cd moorcheh-mcp

2. Install dependencies

   npm install

1. Get your Moorcheh API key

   • Visit Moorcheh Dashboard
   • Sign in to your account
   • Go to your account settings
   • Generate or copy your API key

2. Set up your environment

   # Copy the example environment file
   cp env.example .env

3. Edit the .env file

   # Open .env in your preferred editor
   # Replace 'your_moorcheh_api_key_here' with your actual API key
   MOORCHEH_API_KEY=your_actual_api_key_here

npm start

That's it! Your Moorcheh MCP server is now running and ready to use.

To use the Moorcheh MCP server with Claude Desktop:

1. Download Claude Desktop from https://claude.ai/download
2. Install and launch Claude Desktop

Option A: Using NPX (Recommended)

1. In Claude Desktop, go to Settings → Developer
2. Click Edit Config
3. Configure the server with these settings:

   {
      "mcpServers": { 
            "moorcheh": {
               "command": "npx",
               "args": ["-y", "@moorchehai/mcp"],
               "env": {
                  "MOORCHEH_API_KEY": "your_actual_api_key_here"
               }
            }
      }
   }

Option B: Local Installation

1. In Claude Desktop, go to Settings → Developer

2. Click Edit Config

3. Configure the server with these settings:

   {
      "mcpServers":{ 
            "moorcheh": {
               "command": "node",
               "args": [
               "path\\to\\moorcheh-mcp\\src\\server\\index.js"
               ],
               "env": {
               "NODE_ENV": "development"
               }
            }
      }
   }

4. Important:

   • For Option A: Replace your_actual_api_key_here with your actual Moorcheh API key
   • For Option B: Replace path\\to\\moorcheh-mcp\\src\\server\\index.js with the actual path to your index.js file and create .env in moorcheh-mcp with your API key

5. Save the configuration file and restart Claude Desktop completely

1. Start a new conversation in Claude Desktop
2. Ask Claude to list the available tools: "Can you list down my namespaces?"
3. You should see tools like list-namespaces, search, answer, etc.

To use the Moorcheh MCP server with Cursor IDE:

1. Download Cursor from https://cursor.com
2. Install and launch Cursor

Option A: Using NPX (Recommended)

1. In Cursor, go to Settings → Tools & integration
2. Click Add MCP Server
3. Configure the server with these settings:

{
   "mcpServers": { 
         "moorcheh": {
            "command": "npx",
            "args": ["-y", "@moorchehai/mcp"],
            "env": {
               "MOORCHEH_API_KEY": "your_actual_api_key_here"
            }
         }
   }
}

Option B: Local Installation

1. In Cursor, go to Settings → Tools & integration
2. Click Add MCP Server
3. Configure the server with these settings:

{
   "mcpServers":{ 
         "moorcheh": {
            "command": "node",
            "args": [
            "path\\to\\moorcheh-mcp\\src\\server\\index.js"
            ],
            "env": {
            "NODE_ENV": "development"
            }
         }
   }
}

• For Option A: Replace your_actual_api_key_here with your actual Moorcheh API key in the configuration
• For Option B: Create .env in moorcheh-mcp directory and add your API key with MOORCHEH_API_KEY=your_key_here

1. Open a new chat in Cursor (Cmd/Ctrl + L)
2. Ask the AI to list available Moorcheh tools: "What Moorcheh tools can I use?"
3. You should see tools like list-namespaces, search, answer, etc.

The Moorcheh MCP server provides tools for:

• Namespace Management: Create, list, and delete namespaces for organizing your data
• Document Operations: Upload and manage text documents and vector embeddings
• Advanced Search: Perform semantic search across your data
• AI-Powered Answers: Get intelligent responses based on your stored data

• list-namespaces: View all your available namespaces
• create-namespace: Create a new namespace for storing data
• delete-namespace: Remove a namespace and all its contents

• upload-text: Upload text documents to a namespace
• upload-vectors: Upload vector embeddings to a namespace
• get-data: Retrieve text documents by ID from text namespaces
• delete-data: Remove specific data items from a namespace

• search: Search across namespaces with vector similarity
• answer: Get AI-generated answers based on top of your search

• Node.js: Version 18.0.0 or higher
• Moorcheh Account: Active account with API access
• Git: For cloning the repository

For development with auto-reload:

npm run dev

1. "Missing required API_KEY environment variable"

   • Make sure you've created a .env file
   • Verify your API key is correctly set in the .env file
   • Check that the API key is valid in your Moorcheh dashboard

2. "Forbidden: Check your API key"

   • Your API key may be invalid or expired
   • Generate a new API key from the Moorcheh dashboard
   • Update your .env file with the new key

3. "Network Error"

   • Check your internet connection
   • Verify the API endpoints are accessible
   • Try again in a few minutes

• GitHub Issues: https://github.com/moorcheh-ai/moorcheh-mcp/issues
• Moorcheh Documentation: https://console.moorcheh.ai/docs/mcp
• Moorcheh Dashboard: https://console.moorcheh.ai

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

We welcome contributions! Please feel free to submit a Pull Request.

• Package Name: Updated to @moorchehai/mcp for official Moorcheh organization
• NPX Support: Added CLI wrapper for seamless npx -y @moorchehai/mcp execution
• Package Structure: Configured for npm registry publishing
• CLI Features: Added help, version commands and API key validation
• User Experience: Improved error messages and installation guidance

• NPX Support: Added CLI wrapper for seamless npx -y @moorcheh/mcp execution
• Package Structure: Configured for npm registry publishing as @moorcheh/mcp
• CLI Features: Added help, version commands and API key validation
• User Experience: Improved error messages and installation guidance

• New tool: get-data to fetch documents by ID from text namespaces (POST /namespaces/{name}/documents/get)
• Reliability: Static documentation resources to avoid invalid URI errors in MCP clients
• Windows compatibility: Use ';' for command chaining in PowerShell
• Stability: Ensured stdout handling respects MCP JSON-RPC framing

• Enhanced prompt system with dynamic content generation
• Added comprehensive argument schemas with Zod validation
• Improved search optimization, data organization, and AI answer setup prompts
• Updated prompt registration to use new MCP SDK signature
• Better user guidance and interactive prompt responses

• Initial release with MCP server functionality
• Support for text and vector operations
• AI-powered answer generation
• Comprehensive documentation