[{"_1":2,"_277":-5,"_278":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_236":237},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","XKTmDhQY95","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_156":157},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":64,"_67":68,"_69":68,"_70":71,"_76":77,"_98":-5,"_99":100,"_101":28,"_102":103,"_86":127,"_128":91,"_129":-5,"_130":-5,"_131":132,"_133":134,"_141":-5,"_142":143,"_148":-5,"_110":87,"_149":150,"_152":-5,"_17":153,"_154":155},"addedAt",["D",1742307677710],"argumentsJsonSchema",{"_35":36,"_61":62,"_43":63},"properties",{"_37":38,"_45":46,"_49":50,"_53":54,"_57":58},"HOST",{"_39":40,"_41":42,"_43":44},"default","0.0.0.0","description","Server host address","type","string","PORT",{"_39":47,"_41":48,"_43":44},"8000","Server port number","LOG_LEVEL",{"_39":51,"_41":52,"_43":44},"DEBUG","Logging configuration level","CORS_ORIGINS",{"_39":55,"_41":56,"_43":44},"*","CORS configuration for allowed origins","MAX_MEMORIES",{"_39":59,"_41":60,"_43":44},"0","Maximum number of memories to store (0 for unlimited)","required",[],"object",[65,66],"language:python","license_grade:f","descriptionMarkdown","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. You can use Claude and Cline AI Also","descriptionPlainText","githubProject",{"_72":73,"_74":75},"readme","# TxtAI Assistant MCP\n\nA Model Context Protocol (MCP) server implementation for semantic search and memory management using [txtai](https://github.com/neuml/txtai). This server provides a robust API for storing, retrieving, and managing text-based memories with semantic search capabilities.\n\n## About txtai\n\nThis project is built on top of [txtai](https://github.com/neuml/txtai), an excellent open-source AI-powered search engine created by [NeuML](https://github.com/neuml). txtai provides:\n\n- 🔍 All-in-one semantic search solution\n- 🧠 Neural search with transformers\n- 💡 Zero-shot text classification\n- 🔄 Text extraction and embeddings\n- 🌐 Multi-language support\n- 🚀 High performance and scalability\n\nWe 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.\n\n## Features\n\n- 🔍 Semantic search across stored memories\n- 💾 Persistent storage with file-based backend\n- 🏷️ Tag-based memory organization and retrieval\n- 📊 Memory statistics and health monitoring\n- 🔄 Automatic data persistence\n- 📝 Comprehensive logging\n- 🔒 Configurable CORS settings\n- 🤖 Integration with Claude and Cline AI\n\n## Prerequisites\n\n- Python 3.8 or higher\n- pip (Python package installer)\n- virtualenv (recommended)\n\n## Installation\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/yourusername/txtai-assistant-mcp.git\ncd txtai-assistant-mcp\n```\n\n2. Run the start script:\n```bash\n./scripts/start.sh\n```\n\nThe script will:\n- Create a virtual environment\n- Install required dependencies\n- Set up necessary directories\n- Create a configuration file from template\n- Start the server\n\n## Configuration\n\nThe server can be configured using environment variables in the `.env` file. A template is provided at `.env.template`:\n\n```ini\n# Server Configuration\nHOST=0.0.0.0\nPORT=8000\n\n# CORS Configuration\nCORS_ORIGINS=*\n\n# Logging Configuration\nLOG_LEVEL=DEBUG\n\n# Memory Configuration\nMAX_MEMORIES=0\n```\n\n## Integration with Claude and Cline AI\n\nThis TxtAI Assistant can be used as an MCP server with Claude and Cline AI to enhance their capabilities with semantic memory and search functionality.\n\n### Configuration for Claude\n\nTo 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):\n\n```json\n{\n \"mcpServers\": {\n \"txtai-assistant\": {\n \"command\": \"path/to/txtai-assistant-mcp/scripts/start.sh\",\n \"env\": {}\n }\n }\n}\n```\n\n### Configuration for Cline\n\nTo 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`):\n\n```json\n{\n \"mcpServers\": {\n \"txtai-assistant\": {\n \"command\": \"path/to/txtai-assistant-mcp/scripts/start.sh\",\n \"env\": {}\n }\n }\n}\n```\n\n### Available MCP Tools\n\nOnce configured, the following tools become available to Claude and Cline:\n\n1. `store_memory`: Store new memory content with metadata and tags\n```json\n{\n \"content\": \"Memory content to store\",\n \"metadata\": {\n \"source\": \"conversation\",\n \"timestamp\": \"2023-01-01T00:00:00Z\"\n },\n \"tags\": [\"important\", \"context\"],\n \"type\": \"conversation\"\n}\n```\n\n2. `retrieve_memory`: Retrieve memories based on semantic search\n```json\n{\n \"query\": \"search query\",\n \"n_results\": 5\n}\n```\n\n3. `search_by_tag`: Search memories by tags\n```json\n{\n \"tags\": [\"important\", \"context\"]\n}\n```\n\n4. `delete_memory`: Delete a specific memory by content hash\n```json\n{\n \"content_hash\": \"hash_value\"\n}\n```\n\n5. `get_stats`: Get database statistics\n```json\n{}\n```\n\n6. `check_health`: Check database and embedding model health\n```json\n{}\n```\n\n### Usage Examples\n\nIn Claude or Cline, you can use these tools through the MCP protocol:\n\n```python\n# Store a memory\n\ntxtai-assistant\nstore_memory\n\n{\n \"content\": \"Important information to remember\",\n \"tags\": [\"important\"]\n}\n\n\n\n# Retrieve memories\n\ntxtai-assistant\nretrieve_memory\n\n{\n \"query\": \"what was the important information?\",\n \"n_results\": 5\n}\n\n\n```\n\nThe AI will automatically use these tools to maintain context and retrieve relevant information during conversations.\n\n## API Endpoints\n\n### Store Memory\n```http\nPOST /store\n```\nStore a new memory with optional metadata and tags.\n\n**Request Body:**\n```json\n{\n \"content\": \"Memory content to store\",\n \"metadata\": {\n \"source\": \"example\",\n \"timestamp\": \"2023-01-01T00:00:00Z\"\n },\n \"tags\": [\"example\", \"memory\"],\n \"type\": \"general\"\n}\n```\n\n### Search Memories\n```http\nPOST /search\n```\nSearch memories using semantic search.\n\n**Request Body:**\n```json\n{\n \"query\": \"search query\",\n \"n_results\": 5,\n \"similarity_threshold\": 0.7\n}\n```\n\n### Search by Tags\n```http\nPOST /search_tags\n```\nSearch memories by tags.\n\n**Request Body:**\n```json\n{\n \"tags\": [\"example\", \"memory\"]\n}\n```\n\n### Delete Memory\n```http\nDELETE /memory/{content_hash}\n```\nDelete a specific memory by its content hash.\n\n### Get Statistics\n```http\nGET /stats\n```\nGet system statistics including memory counts and tag distribution.\n\n### Health Check\n```http\nGET /health\n```\nCheck the health status of the server.\n\n## Directory Structure\n\n```\ntxtai-assistant-mcp/\n├── server/\n│ ├── main.py # Main server implementation\n│ └── requirements.txt # Python dependencies\n├── scripts/\n│ └── start.sh # Server startup script\n├── data/ # Data storage directory\n├── logs/ # Log files directory\n├── .env.template # Environment configuration template\n└── README.md # This file\n```\n\n## Data Storage\n\nMemories and tags are stored in JSON files in the `data` directory:\n- `memories.json`: Contains all stored memories\n- `tags.json`: Contains the tag index\n\n## Logging\n\nLogs are stored in the `logs` directory. The default log file is `server.log`.\n\n## Development\n\nTo contribute to this project:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Error Handling\n\nThe server implements comprehensive error handling:\n- Invalid requests return appropriate HTTP status codes\n- Errors are logged with stack traces\n- User-friendly error messages are returned in responses\n\n## Security Considerations\n\n- CORS settings are configurable via environment variables\n- File paths are sanitized to prevent directory traversal\n- Input validation is performed on all endpoints\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the GitHub repository.\n","url","https://github.com/rmtech1/txtai-assistant-mcp","githubRepository",{"_78":79,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_93":94,"_95":-5,"_96":97},"defaultBranch","main","fullName","rmtech1/txtai-assistant-mcp","githubTreeId",94213,"language","Python","name","txtai-assistant-mcp","owner",{"_90":91,"_17":92},"login","rmtech1","s62ciz1bn5","recentStargazers",1,"spdxLicense","stargazers",4,"glamaJson","id",1940,"inspectable","integrations",[104,114,121],{"_105":106,"_41":112,"_17":113},"brand",{"_107":108,"_86":109,"_110":111},"logoSvgPath","M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","slug","dotenv","Supports configuration through environment variables in .env files, allowing customization of server settings, CORS configurations, and memory parameters","ongp08s1n3",{"_105":115,"_41":119,"_17":120},{"_107":116,"_86":117,"_110":118},"M0 14.727h.941v-2.453c0-.484.318-.835.771-.835.439 0 .71.276.71.722v2.566h.915V12.25c0-.48.31-.812.764-.812.46 0 .718.28.718.77v2.518h.94v-2.748c0-.801-.517-1.334-1.307-1.334-.578 0-1.054.31-1.247.805h-.023c-.147-.514-.552-.805-1.118-.805-.545 0-.968.306-1.142.771H.903v-.695H0v4.006zm7.82-.646c-.408 0-.68-.208-.68-.537 0-.318.26-.522.714-.552l.926-.057v.307c0 .483-.427.839-.96.839zm-.284.71c.514 0 1.017-.268 1.248-.703h.018v.639h.908v-2.76c0-.804-.647-1.33-1.64-1.33-1.021 0-1.66.537-1.701 1.285h.873c.06-.332.344-.548.79-.548.464 0 .748.242.748.662v.287l-1.058.06c-.976.061-1.524.488-1.524 1.199 0 .721.564 1.209 1.338 1.209zm6.305-2.642c-.065-.843-.719-1.512-1.777-1.512-1.164 0-1.92.805-1.92 2.087 0 1.3.756 2.082 1.928 2.082 1.005 0 1.697-.59 1.772-1.485h-.888c-.087.453-.397.725-.873.725-.597 0-.982-.483-.982-1.322 0-.824.381-1.323.975-1.323.502 0 .8.321.876.748h.889zm2.906-2.967c-1.591 0-2.589 1.085-2.589 2.82 0 1.735.998 2.816 2.59 2.816 1.586 0 2.584-1.081 2.584-2.816 0-1.735-.997-2.82-2.585-2.82zm0 .832c.971 0 1.591.77 1.591 1.988 0 1.213-.62 1.984-1.59 1.984-.976 0-1.592-.77-1.592-1.984 0-1.217.616-1.988 1.591-1.988zm2.982 3.178c.042 1.006.866 1.626 2.12 1.626 1.32 0 2.151-.65 2.151-1.686 0-.813-.469-1.27-1.576-1.523l-.627-.144c-.67-.158-.945-.37-.945-.733 0-.453.415-.756 1.032-.756.623 0 1.05.306 1.096.817h.93c-.023-.96-.817-1.61-2.019-1.61-1.187 0-2.03.653-2.03 1.62 0 .78.477 1.263 1.482 1.494l.707.166c.688.163.967.39.967.782 0 .454-.457.779-1.115.779-.665 0-1.167-.329-1.228-.832h-.945z","macOS","macos","Includes specific integration instructions for macOS, detailing configuration file locations for Claude's MCP settings","hruye5idjd",{"_105":122,"_41":125,"_17":126},{"_107":123,"_86":85,"_110":124},"M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z","python","Built on Python with txtai, providing semantic search functionality, neural search with transformers, and text extraction capabilities","qlj2gcb11x","TxtAi Memory Vector Server","namespace","npmPackage","prompts","redditPostForeignId","1jfxocv","relatedMcpServerIds",[135,136,137,138,139,140],1471,1519,999,810,1539,758,"resources","scores",{"_144":145,"_146":-5,"_147":-5},"license",0,"quality","security","simpleIcon","supportedPlatforms",[151],"MACOS","tools","eyslv880qg","updatedAt",["D",1742586477656],"meta",[158,161,163,170,173,175,178,181,184,187,190,192,195,198,200,202,204,206,208],{"_159":160},"title","TxtAi Memory Vector Server | Glama",{"_162":68,"_86":41},"content",{"_164":165,"_166":167,"_168":169},"href","https://glama.ai/mcp/servers/@rmtech1/txtai-assistant-mcp","rel","canonical","tagName","link",{"_162":127,"_171":172},"property","og:title",{"_162":68,"_171":174},"og:description",{"_162":176,"_171":177},"https://glama.ai/logo.png","og:logo",{"_162":179,"_171":180},"https://glama.ai/mcp/servers/@rmtech1/txtai-assistant-mcp/og-image","og:image",{"_162":182,"_171":183},"630","og:image:height",{"_162":185,"_171":186},"1200","og:image:width",{"_162":188,"_171":189},"website","og:type",{"_162":165,"_171":191},"og:url",{"_162":193,"_171":194},"ChatGPT alternative for power users","og:site_name",{"_162":196,"_86":197},"summary_large_image","twitter:card",{"_162":193,"_86":199},"twitter:title",{"_162":68,"_86":201},"twitter:description",{"_162":179,"_86":203},"twitter:image",{"_162":182,"_86":205},"twitter:image:height",{"_162":185,"_86":207},"twitter:image:width",{"_209":210},"script:ld+json",{"_211":212,"_213":214},"@context","http://schema.org","@graph",[215],{"_211":216,"_217":218,"_219":220},"https://schema.org","@type","BreadcrumbList","itemListElement",[221,227,231,235],{"_217":222,"_223":224,"_86":225,"_226":94},"ListItem","item","https://glama.ai/","Glama","position",{"_217":222,"_223":228,"_86":229,"_226":230},"https://glama.ai/mcp","MCP",2,{"_217":222,"_223":232,"_86":233,"_226":234},"https://glama.ai/mcp/servers","Servers",3,{"_217":222,"_223":165,"_86":127,"_226":97},"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_238":239,"_243":79,"_29":244,"_269":270,"_271":272},"blob",{"_162":240,"_241":242},"fastapi>=0.68.0\nuvicorn>=0.15.0\npython-dotenv>=0.19.0\npydantic>=1.8.0\ntxtai>=5.0.0\npython-multipart>=0.0.5\ntyping-extensions>=4.0.0\n","fileName","requirements.txt","branch",{"_31":245,"_33":246,"_13":254,"_67":68,"_69":68,"_70":255,"_76":256,"_98":-5,"_99":100,"_101":28,"_102":258,"_86":127,"_128":91,"_129":-5,"_130":-5,"_131":132,"_133":265,"_141":-5,"_142":266,"_148":-5,"_110":87,"_149":267,"_152":-5,"_17":153,"_154":268},["D",1742307677710],{"_35":247,"_61":253,"_43":63},{"_37":248,"_45":249,"_49":250,"_53":251,"_57":252},{"_39":40,"_41":42,"_43":44},{"_39":47,"_41":48,"_43":44},{"_39":51,"_41":52,"_43":44},{"_39":55,"_41":56,"_43":44},{"_39":59,"_41":60,"_43":44},[],[65,66],{"_72":73,"_74":75},{"_78":79,"_80":81,"_82":83,"_84":85,"_86":87,"_88":257,"_93":94,"_95":-5,"_96":97},{"_90":91,"_17":92},[259,261,263],{"_105":260,"_41":112,"_17":113},{"_107":108,"_86":109,"_110":111},{"_105":262,"_41":119,"_17":120},{"_107":116,"_86":117,"_110":118},{"_105":264,"_41":125,"_17":126},{"_107":123,"_86":85,"_110":124},[135,136,137,138,139,140],{"_144":145,"_146":-5,"_147":-5},[151],["D",1742586477656],"path","server","treeMembers",[273,275],{"_269":274,"_43":238},"server/main.py",{"_269":276,"_43":238},"server/requirements.txt","actionData","errors"]