MCP Node

🚀 Model Context Protocol (MCP) Node.js Tool

This project is a Node.js tool named "Model Context Protocol" (MCP). It enables integration with Claude Desktop and provides functionality to interact with Algolia services. Refer to the LICENSE file for usage terms.

🚀 Quick Start

Project Dependencies

• Node.js 22 or higher
• npm

Installation Steps

1. Clone the repository:

   git clone https://github.com/algolia/mcp-node
   cd mcp-node
   npm install
   

2. Build the project:

   npm run build -- --outfile dist/algolia-mcp
   

3. After installation, you can find the built files in the dist/algolia-mcp directory.

✨ Features

• Provide an MCP interface for interacting with Algolia services.
• Support starting the server via the command line and managing authentication status.
• Integrate with Claude Desktop to enhance functionality.

💻 Usage Examples

Basic Usage

Example 1: Start the MCP Server

npm run start-server -- --allow-tools listIndices,getSettings,searchSingleIndex

Example 2: Authentication

npm run authenticate

Example 3: View Logs

Log file storage paths:

• macOS: ~/Library/Logs/algolia-mcp/
• Windows: %APPDATA%\algolia-mcp\logs\
• Linux: ~/.config/algolia-mcp/logs/

📦 Installation

Global Installation

npm install -g algolia-mcp

Local Development Environment Setup

1. Clone the repository and enter the directory:

   git clone https://github.com/algolia/mcp-node
   cd mcp-node
   

2. Install dependencies:

   npm install
   

3. Start the development server:

   npm run start
   

📚 Documentation

Development Configuration

Create or modify package.json in the project root directory and add the following content:

{
  "scripts": {
    "start": "node src/app.ts"
  }
}

🔧 Technical Details

Troubleshooting

Common Issues

1. "Application not responding" error:
   • Ensure the quarantined attribute is removed on macOS:

     xattr -d com.apple Quarternary-attribute /path/to/algolia-mcp
     

2. Authentication failure:
   • Try logging out and then authenticating again.
3. Claude cannot access tools:
   • Check and confirm that the MCP configuration is correct in the Claude Desktop settings.

Contribution Guide

1. Create a feature branch:

   git checkout -b feature/amazing-feature
   

2. Commit changes:

   git commit -m 'Add awesome feature'
   

3. Push to the remote repository:

   git push origin feature/amazing-feature
   

4. Create a pull request.

📄 License

Algolia Node.js MCP is licensed under the MIT License. Refer to the LICENSE file for specific terms.

⚠️ Important Note

This code example is provided by Algolia for reference purposes only. Do not use it in a production environment and use it with caution after thorough testing.