mcp-server-weaviate

MCP server for Weaviate

🏎️ Quickstart

This repository contains the MCP (Message Content Protocol) server implementation designed to interface with Weaviate. It enables Claude to interact with Weaviate as a knowledge base.

Prerequisites

• Ensure uv is installed. Refer to the uv documentation for installation instructions.
• Clone this repository.

Install

Installing via Smithery

To install the Weaviate MCP Server for Claude Desktop automatically using Smithery, execute:

npx -y @smithery/cli install @weaviate/mcp-server-weaviate --client claude

Claude Desktop

To configure the server manually, modify the claude_desktop_config.json file located in:

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

Add a configuration block similar to the following, replacing the placeholder values with your actual Weaviate and OpenAI credentials:

{
  "mcpServers": {
    "mcp-server-weaviate": {
      "command": "PYTHON_PATH",
      "args": [
        "-m",
        "src.server",
        "--weaviate-url",
        "YOUR_WEAVIATE_URL",
        "--weaviate-api-key",
        "YOUR_WEAVIATE_API_KEY",
        "--search-collection-name",
        "YOUR_SEARCH_COLLECTION",
        "--store-collection-name",
        "YOUR_STORE_COLLECTION",
        "--openai-api-key",
        "YOUR_OPENAI_API_KEY"
      ],
      "env": {
        "PYTHONPATH": "PATH_TO_MCP_SERVER_WEAVIATE_DIRECTORY"
      }
    }
  }
}