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.
Model Context Protocol (MCP) server implementation for semantic vector search and memory management using TxtAI. This server provides a robust API for storing, retrieving, and managing text-based memories with semantic vector database search capabilities. You can use Claude and Cline AI as well.
星數
15
工具
—
可用率
—
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
Clone this repository:
git clone https://github.com/yourusername/txtai-assistant-mcp.git
cd txtai-assistant-mcp
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:
# Server Configuration
HOST=0.0.0.0
PORT=8000
# CORS Configuration
CORS_ORIGINS=*
# Logging Configuration
LOG_LEVEL=DEBUG
# Memory Configuration
MAX_MEMORIES=0
Integration with Claude and Cline AI
This TxtAI Assistant can be used as an MCP server with Claude and Cline AI to enhance their capabilities with semantic memory and search functionality.
Configuration for Claude
To use this server with Claude, add it to Claude's MCP configuration file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
To use with Cline, add the server configuration to Cline's MCP settings file (typically located at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):
Get system statistics including memory counts and tag distribution.
Health Check
GET /health
Check the health status of the server.
Directory Structure
txtai-assistant-mcp/
├── server/
│ ├── main.py # Main server implementation
│ └── requirements.txt # Python dependencies
├── scripts/
│ └── start.sh # Server startup script
├── data/ # Data storage directory
├── logs/ # Log files directory
├── .env.template # Environment configuration template
└── README.md # This file
Data Storage
Memories and tags are stored in JSON files in the data directory:
memories.json: Contains all stored memories
tags.json: Contains the tag index
Logging
Logs are stored in the logs directory. The default log file is server.log.
Development
To contribute to this project:
Fork the repository
Create a feature branch
Make your changes
Submit a pull request
Error Handling
The server implements comprehensive error handling:
Invalid requests return appropriate HTTP status codes
Errors are logged with stack traces
User-friendly error messages are returned in responses
Security Considerations
CORS settings are configurable via environment variables
File paths are sanitized to prevent directory traversal
Input validation is performed on all endpoints
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
If you encounter any issues or have questions, please file an issue on the GitHub repository.
T
Txtai Assistant
rmtech1·15 顆星·
Model Context Protocol (MCP) server implementation for semantic vector search and memory management using TxtAI. This server provides a robust API for storing, retrieving, and managing text-based memo
Model Context Protocol (MCP) server implementation for semantic vector search and memory management using TxtAI. This server provides a robust API for storing, retrieving, and managing text-based memories with semantic vector database search capabilities. You can use Claude and Cline AI as well.
上次檢查時間:2026-10-28。 Model Context Protocol (MCP) server implementation for semantic vector search and memory management using TxtAI. This server provides a robust API for storing, retrieving, and managing text-based memories with semantic vector database search capabilities. You can use Claude and Cline AI as well.