TxtAI Assistant MCP

A Model Context Protocol (MCP) server implementation for semantic search and memory management using txtai. This server provides a robust API for storing, retrieving, and managing text-based memories with semantic search capabilities.

About txtai

This project is built on top of txtai, an excellent open-source AI-powered search engine created by NeuML. txtai provides:

- 🔍 All-in-one semantic search solution
- 🧠 Neural search with transformers
- 💡 Zero-shot text classification
- 🔄 Text extraction and embeddings
- 🌐 Multi-language support
- 🚀 High performance and scalability

We extend txtai's capabilities by integrating it with the Model Context Protocol (MCP), enabling AI assistants like Claude and Cline to leverage its powerful semantic search capabilities. Special thanks to the txtai team for creating such a powerful and flexible tool.

Features

- 🔍 Semantic search across stored memories
- 💾 Persistent storage with file-based backend
- 🏷️ Tag-based memory organization and retrieval
- 📊 Memory statistics and health monitoring
- 🔄 Automatic data persistence
- 📝 Comprehensive logging
- 🔒 Configurable CORS settings
- 🤖 Integration with Claude and Cline AI

Prerequisites

- Python 3.8 or higher
- pip (Python package installer)
- virtualenv (recommended)

Installation

1. Clone this repository:

git clone https://github.com/yourusername/txtai-assistant-mcp.git

cd txtai-assistant-mcp

2. Run the start script:

./scripts/start.sh

The script will:
- Create a virtual environment
- Install required dependencies
- Set up necessary directories
- Create a configuration file from template
- Start the server

Configuration

The server can be configured using environment variables in the .env file. A template is provided at .env.template:

```ini