TxtAI Assistant MCP
2025.01.11
4
Python语义搜索记忆管理AI助手集成搜索工具开发效率
TxtAI Assistant MCP 是一个基于 Model Context Protocol (MCP) 的服务实现,专注于语义搜索和记忆管理。它利用 txtai 的强大功能,为存储、检索和管理基于文本的记忆提供健壮的 API。该服务特别适合与 AI 助手(如 Claude 和 Cline)集成,以增强其语义搜索和记忆管理能力。
View on GitHub
Overview
基本能力
产品定位
TxtAI Assistant MCP 是一个语义搜索和记忆管理服务,旨在为 AI 助手提供强大的记忆存储和检索功能。
核心功能
- 🔍 语义搜索存储的记忆
- 💾 基于文件的持久化存储
- 🏷️ 基于标签的记忆组织和检索
- 📊 记忆统计和健康监控
- 🔄 自动数据持久化
- 📝 全面的日志记录
- 🔒 可配置的 CORS 设置
- 🤖 与 Claude 和 Cline AI 集成
适用场景
- AI 助手的记忆管理
- 语义搜索应用
- 基于标签的信息检索
- 对话系统的上下文管理
工具列表
store_memory: 存储带有元数据和标签的新记忆内容retrieve_memory: 基于语义搜索检索记忆search_by_tag: 按标签搜索记忆delete_memory: 通过内容哈希删除特定记忆get_stats: 获取数据库统计信息check_health: 检查数据库和嵌入模型健康状况
常见问题解答
- 如何配置 CORS 设置?通过
.env文件中的CORS_ORIGINS环境变量 - 数据存储在哪里?在
data目录下的 JSON 文件中 - 如何查看日志?日志存储在
logs目录下的server.log文件中
使用教程
使用依赖
- Python 3.8 或更高版本
- pip (Python 包安装程序)
- virtualenv (推荐)
安装教程
- 克隆仓库:
git clone https://github.com/yourusername/txtai-assistant-mcp.git
cd txtai-assistant-mcp
- 运行启动脚本:
./scripts/start.sh
调试方式
- 检查日志文件:
logs/server.log - 健康检查端点:
GET /health - 获取统计信息:
GET /stats