MCP server for the Mixedbread Platform
npm install @mixedbread/mcp

Connect your Mixedbread vector stores to any MCP-compatible client through the Model Context Protocol. Our MCP allows you to manage and search your vector store documents in natural language. Reduce your search time and improve your code output quality through rag in coding agents like claude code and cursor.
The Mixedbread MCP Server allows you to:
- Create and manage vector stores for your documents
- Upload and process files with automated chunking and embedding
- Retrieve specific files and their contents
- Build AI-native search experiences directly in any MCP-Client
- Node.js: Version 20 or higher
- Mixedbread API Key: Get yours at platform.mixedbread.com
- MCP Client: Claude Desktop or another MCP-compatible client
- Optional: @modelcontextprotocol/server-filesystem for local file uploads
``bash`
npm install -g @mixedbread/mcp
`bash`
npx @mixedbread/mcp
You should see the MCP server start message if installed correctly.
1. Open your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
- Windows: ~/.config/Claude/claude_desktop_config.json
- Linux:
2. Add the Mixedbread MCP server configuration:
`json`
{
"mcpServers": {
"mixedbread": {
"command": "npx",
"args": ["-y", "@mixedbread/mcp"],
"env": {
"MXBAI_API_KEY": "mxb_your_api_key_here"
}
}
}
}
To upload local files, also configure the filesystem MCP server:
`json`
{
"mcpServers": {
"mixedbread": {
"command": "npx",
"args": ["-y", "@mixedbread/mcp"],
"env": {
"MXBAI_API_KEY": "mxb_your_api_key_here"
}
},
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/your/documents"
]
}
}
}
- MXBAI_API_KEY: Your Mixedbread API key (required)
Once configured, you can interact with your vector stores using natural language in Claude Desktop:
"Create a new vector store called 'Product Documentation'"
`$3
`
"Upload all markdown files from the docs folder to my Product Documentation store"
`$3
`
"Search for information about authentication in the Product Documentation store"
`$3
`
"List all my vector stores"
`$3
`
"Find all files in the Product Documentation store that mention API endpoints"
`Development
$3
`bash
Clone the repository
git clone https://github.com/mixedbread-ai/openbread.git
cd openbread/packages/mcpInstall dependencies
npm installBuild the server
npm run buildRun in development mode
npm run dev
`$3
`bash
Run all tests
npm testRun with coverage
npm run test:coverageWatch mode for development
npm run test:watch
`Security
$3
- Store API keys securely in environment variables
- Never commit API keys to version control
- Use separate API keys for development and production
- Rotate keys regularlyTroubleshooting
$3
#### "API key not found" error
- Verify your API key starts with
mxb_
- Check the key is correctly set in Claude Desktop config
- Ensure there are no extra spaces or quotes around the key#### "Cannot connect to Mixedbread API"
- Check your internet connection
- Verify the API endpoint is accessible
- Ensure your firewall allows outbound HTTPS connections
#### "File upload failed"
- Confirm the filesystem MCP server is configured
- Check file paths are within allowed directories
#### Tools not appearing in Claude
- Restart Claude Desktop after configuration changes
- Check the MCP server is running (test with
npx @mixedbread/mcp`)- Mixedbread Documentation: mixedbread.com/docs
- MCP Documentation: mixedbread.com/mcp
- API Reference: mixedbread.com/api-reference
- Model Context Protocol: modelcontextprotocol.io
- GitHub Issues: github.com/mixedbread-ai/openbread/issues
- Support: support@mixedbread.com
This project is licensed under the Apache License 2.0.
---
š Baked with love by Mixedbread