MCPgee
MCPgee
MCPgeeMCPgee

Minds

v1.0.0•Communication•stable

An MCP (Model Context Protocol) server for Minds, allowing LLMs to interact with the Minds SDK through a standardized interface.

mindsmcpai-integration
Share:
29
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Minds?

Minds is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp (model context protocol) server for minds, allowing llms to interact with the minds sdk through a standardized interface.

An MCP (Model Context Protocol) server for Minds, allowing LLMs to interact with the Minds SDK through a standardized interface.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP (Model Context Protocol) server for Minds, allowing L

Use Cases

Interact with Minds SDK
mindsdb

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedApr 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx minds

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Minds

The Minds MCP Server connects LLMs to MindsDB's Minds SDK through the Model Context Protocol, exposing the ability to list available Minds and generate completions via any configured Mind directly from within an MCP-compatible AI client. Minds in MindsDB are AI-powered data agents that can answer questions over connected databases, APIs, and data sources. This server runs as a Python FastMCP application and communicates over SSE, making it suitable for integration with Claude Desktop or any MCP client that supports HTTP/SSE transport.

Prerequisites

  • Python 3.8 or higher with pip
  • A MindsDB account at https://mdb.ai and an API key
  • At least one Mind configured in your MindsDB account
  • An MCP-compatible client that supports SSE transport (e.g., Claude Desktop with mcp-remote)
1

Clone the repository

Clone the minds-mcp repository to your local machine.

git clone https://github.com/mindsdb/minds-mcp.git
cd minds-mcp
2

Create and activate a virtual environment

Use a Python virtual environment to isolate dependencies.

python -m venv env
source env/bin/activate  # On Windows: env\Scripts\activate
3

Install dependencies

Install the required Python packages from the requirements files.

pip install -r requirements.txt
4

Configure environment variables

Set the MINDS_BASE_URL if using a self-hosted MindsDB instance (defaults to https://mdb.ai). Your API key is passed per-request rather than as a server-level env var.

# Optional: override the default MindsDB endpoint
export MINDS_BASE_URL=https://mdb.ai

# Optional: enable debug logging
export FASTMCP_DEBUG=true
export FASTMCP_LOG_LEVEL=INFO
5

Start the server

Run the server. It will listen on 0.0.0.0:8000 by default with SSE at /sse.

python -m server
6

Connect your MCP client

Point your MCP client at http://localhost:8000/sse. For Claude Desktop, use mcp-remote or a compatible SSE proxy to connect.

Minds Examples

Client configuration

Claude Desktop configuration using mcp-remote to connect to the Minds MCP server running locally over SSE.

{
  "mcpServers": {
    "minds": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8000/sse"
      ]
    }
  }
}

Prompts to try

Example prompts for interacting with MindsDB Minds through the MCP server. Replace 'my_mind' with the actual name of a Mind configured in your MindsDB account.

- "List all the Minds available in my MindsDB account using API key sk-..."
- "Ask my_mind: What were the top 5 products by revenue last quarter?"
- "Use the sales_analyst Mind to generate a completion: Summarize the trend in customer churn over the past 6 months"
- "Query my_mind with my API key to answer: Which regions have the highest return rates?"

Troubleshooting Minds

Server fails to start with ModuleNotFoundError

Ensure the virtual environment is activated (source env/bin/activate) before running python -m server. Run pip install -r requirements.txt again if modules are still missing.

Completion tool returns an authentication error

The api_key parameter must be passed with each tool call — it is not stored server-side. Obtain your MindsDB API key from https://mdb.ai and pass it explicitly in the tool's api_key argument.

Claude Desktop cannot connect to the SSE endpoint

Claude Desktop requires stdio or HTTP+SSE via mcp-remote. Install mcp-remote (npm install -g mcp-remote) and configure the client to use npx mcp-remote http://localhost:8000/sse as shown in the client config example.

Frequently Asked Questions about Minds

What is Minds?

Minds is a Model Context Protocol (MCP) server that mcp (model context protocol) server for minds, allowing llms to interact with the minds sdk through a standardized interface. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Minds?

Follow the installation instructions on the Minds GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Minds?

Minds works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Minds free to use?

Yes, Minds is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Minds Alternatives — Similar Communication Servers

Looking for alternatives to Minds? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.

Slack

★ 86.1k

Enables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl

LibreChat

★ 37.3k

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA

Note Gen

★ 11.9k

A cross-platform Markdown AI note-taking software.

DeepChat

★ 5.8k

🐬DeepChat - A smart assistant that connects powerful AI to your personal world

WhatsApp MCP

★ 5.7k

Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without

Apple

★ 3.1k

Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

CommunicationBrowse All Servers

Quick Config Preview

{ "mcpServers": { "minds": { "command": "npx", "args": ["-y", "minds"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Minds?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides