Moorcheh MCP Server

Quick Start Guide

Follow these simple steps to get your Moorcheh MCP server up and running:

Step 1: Installation

1. Clone the repository

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

2. Install dependencies

   npm install
   

Step 2: Configure Your API Key

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
   

Step 3: Start the Server

npm start

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

Setting Up with Claude Desktop

To use the Moorcheh MCP server with Claude Desktop:

https://github.com/user-attachments/assets/fccbba8e-7393-4b74-8a73-769b55b3f3a3

Step 1: Install Claude Desktop

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

Step 2: Configure MCP Server

Configuration

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: Replace path\\to\\moorcheh-mcp\\src\\server\\index.js with the actual path to your index.js file in server

5. Create .env in moorcheh-mcp and have your api key with MOORCHEH_API_KEY

6. Save the configuration file and restart Claude Desktop completely

Step 3: Test the Connection

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.

Setting Up with Cursor

To use the Moorcheh MCP server with Cursor IDE:

Step 1: Install Cursor

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

Step 2: Configure MCP Server

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"
                  }
               }
         }
      }

Step 3: Create .env in moorcheh-mcp and have your api key with MOORCHEH_API_KEY

Step 4: Test the Connection

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.

What This Server Does

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

Available Tools

Namespace Tools

• 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

Data Tools

• upload-text: Upload text documents to a namespace
• upload-vectors: Upload vector embeddings to a namespace
• delete-data: Remove specific data items from a namespace

Search & AI Tools

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

Supported Bedrock Models

Prerequisites

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

Development

Development Mode

For development with auto-reload:

npm run dev

Available Scripts

Environment Variables

Troubleshooting

Common Issues

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

Getting Help

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

License

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

Contributing

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

Changelog

v1.1.0

• 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

v1.0.0

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