Weaviate MCP Server

🚀 Server Template for Cursor IDE MCP

This is a simple template for creating custom tools for the Cursor IDE using the Model Context Protocol (MCP). After creating your own repository from this template, you can modify the tool and connect it to your Cursor IDE.

🚀 Quick Start

1. Click the "Deploy to Heroku" button:

   

2. After deployment, configure Cursor:

   • Open "Cursor Settings" → "Features".
   • Add a new MCP server.
   • Use your Heroku URL and the /sse path (e.g., https://<your-app-name>.herokuapp.com/sse).

3. Test the mood of the proxy in Cursor:

   • Ask your proxy: "Please tell me how our server is feeling."
   • The server will respond with a friendly message and a ❤️.

✨ Alternative Setup Methods

You can run the server in three ways: using Docker, traditional Python setup, or directly in the Cursor IDE.

📦 Docker Setup

This project includes Docker support for easy deployment:

1. Initial setup:

# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

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

2. Build and run using Docker Compose:

# Build and start the server
docker compose up --build -d

# View logs
docker compose logs -f

# Check the server status
docker compose ps

# Stop the server
docker compose down

3. The server will be available at the following address:

   • SSE endpoint: http://localhost:8000/sse

4. Quick test:

# Test the server endpoint
curl -i http://localhost:8000/sse

5. Connect to the Cursor IDE:
   • Right-click on the "cursor-run-mcp-server.sh" file in Cursor.
   • Select "Copy Path" to copy the absolute path.
   • Open Cursor settings (gear icon).
   • Go to the "Features" tab.
   • Scroll to the bottom to "MCP Servers".
   • Click "Add New MCP Server".
   • Enter the following information:
     • Name: Docker MCP Server
     • Type: Custom
     • Command: bash -c "cd /path/to/server && npm run dev" (adjust according to the actual path)
     • Description (optional): Fill in the description.
   • Click "Done".

📦 Traditional Setup

1. Clone the repository:

git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

2. Install dependencies:

npm install

3. Start the server:

npm run dev

4. Connect to the Cursor IDE:
   • Right-click on the "cursor-run-mcp-server.sh" file in Cursor.
   • Select "Copy Path" to copy the absolute path.
   • Open Cursor settings (gear icon).
   • Go to the "Features" tab.
   • Scroll to the bottom to "MCP Servers".
   • Click "Add New MCP Server".
   • Enter the following information:
     • Name: Local MCP Server
     • Type: Custom
     • Command: bash -c "cd /path/to/server && npm run dev" (adjust according to the actual path)
     • Description (optional): Fill in the description.
   • Click "Done".

🔧 Environment Variables

You can define the following environment variables in the .env file:

• PORT=3000: The port on which the server runs, defaulting to 3000.
• NODE_ENV=development: The Node.js environment mode, which can be set to production.

📦 Installation with Smithery

If you use Smithery, run the following commands:

# Install the Smithery CLI
npm install -g @smithery/cli

# Initialize a new Smithery service in the project folder
smithery init

# Add and install the MCP server template
smithery add mcp-server
smithery install

🔍 Glama Server Review