# Agent Knowledge MCP 🔍
**The complete knowledge management solution**
Powerful Model Context Protocol server for Elasticsearch integration with comprehensive file management and version control.
[](https://python.org)
[](https://modelcontextprotocol.io)
[](https://opensource.org/licenses/MIT)
[](https://coff.ee/itshare4u)
[](https://github.com/sponsors/itshare4u)
## 🚀 What is Agent Knowledge MCP?
The most comprehensive MCP server that transforms your AI assistant into a powerful knowledge management system. **The key advantage? It combines everything you need**—Elasticsearch search, file operations, document validation, and version control in one unified solution.
**🔑 Complete Knowledge Management:**
- ✅ **Elasticsearch Integration**: Full-featured search, indexing, and document management
- ✅ **File System Control**: Comprehensive file operations with cross-platform support
- ✅ **Document Validation**: Schema-enforced document structure with strict validation modes
- ✅ **Configuration Management**: Complete config control with validation and reloading
- ✅ **Version Control**: Git and SVN support with intelligent file tracking
- ✅ **Security First**: Sandboxed operations with configurable restrictions
- ✅ **Production Ready**: Battle-tested with comprehensive error handling
**✨ Key Benefits:**
- 🎯 **34 Powerful Tools**: Everything from search to version control and config management with strict schema validation
- 🔄 **Universal AI Support**: Works with Claude, ChatGPT, Cursor, and any MCP-compatible AI
- 📊 **Smart Document Management**: Auto-validation, templates, and structured data with configurable strict schema control
- 🛡️ **Enterprise Security**: Path validation, access controls, and audit trails
- ⚡ **Zero Dependencies**: Optional Elasticsearch - works standalone for file operations
## 🌐 AI Assistant Support
Works with **any MCP-compatible AI assistant**:
- ✅ **Claude Desktop**
- ✅ **ChatGPT Plus** (with MCP support)
- ✅ **Cursor IDE**
- ✅ **Windsurf**
- ✅ **VS Code** (with MCP extension)
- ✅ **Any MCP client**
Perfect for **developers** who want to automate knowledge management and **teams** who need structured document workflows!
## 🎬 What You Can Do
**Real workflows you can try today:**
### 📚 Knowledge Management
- **"Search all documents for information about API authentication and create a comprehensive guide"**
- **"Index this technical document with proper categorization and tags"**
- **"Find all documents related to deployment and generate a deployment checklist"**
- **"Create a new document template for API documentation with required fields"**
### 📁 File Operations & Organization
- **"Organize all markdown files by category and move them to appropriate directories"**
- **"Read all configuration files and create a settings summary document"**
- **"Find duplicate files in the project and list them for cleanup"**
- **"Create a project structure document listing all important files"**
### 🔄 Version Control & History
- **"Setup Git repository for this knowledge base and commit all current documents"**
- **"Check what changes were made to the user manual in the last version"**
- **"Commit these updated API docs with a descriptive message"**
- **"Show me the previous version of this configuration file"**
### 🤖 Development & Documentation
- **"Index all code documentation and make it searchable"**
- **"Create a changelog from Git commit history"**
- **"Validate all documents follow our schema requirements"**
- **"Generate project documentation from README files"**
### 🔍 Configuration & Schema Management
- **"Update configuration to enable strict schema validation for all documents"**
- **"Show me the current configuration settings and validation rules"**
- **"Validate this configuration before applying it to prevent errors"**
- **"Disable extra fields in documents to enforce strict schema compliance"**
### 🔍 Advanced Search & Analysis
- **"Search across all documents and files for security-related information"**
- **"Find all TODO comments in code files and create a task list"**
- **"Analyze document metadata and generate a content report"**
- **"Search for outdated information and flag it for review"**
## ☕ Support This Project
If you find this MCP server useful, consider supporting its development:
[](https://coff.ee/itshare4u)
[](https://github.com/sponsors/itshare4u)
[](https://paypal.me/itshare4u)
[](https://ko-fi.com/itshare4u)
### 💝 Why Support?
- 🚀 **Faster development** of new features and improvements
- 🐛 **Priority bug fixes** and technical support
- 📚 **Better documentation** and comprehensive tutorials
- 🎯 **Community-requested features** implementation
- 🛡️ **Enhanced security** and stability updates
- 🌟 **Long-term project sustainability**
### 🎁 Sponsor Benefits
| Tier | Amount | Benefits |
|------|--------|----------|
| ☕ **Coffee** | $5 | Thank you mention in README + priority issue responses |
| 🚀 **Supporter** | $15 | Feature request consideration + early access to updates |
| 💎 **Sponsor** | $30 | Logo in README + special recognition in releases |
| 🌟 **Gold Sponsor** | $50+ | Custom benefits discussion + direct communication channel |
**Every contribution helps maintain and improve this open-source project! 🙏**
## ⚡ Quick Start
### 1. Installation
```bash
# Install with uvx (recommended)
uvx agent-knowledge-mcp
```
### 2. Configuration
```bash
# Copy and edit configuration
cp src/config.json.example src/config.json
nano src/config.json
```
### 3. Connect to Your AI Assistant
**Claude Desktop** - Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"agent-knowledge": {
"command": "uvx",
"args": ["agent-knowledge-mcp"]
}
}
}
```
**VS Code** - Quick install buttons:
[](https://insiders.vscode.dev/redirect/mcp/install?name=agent-knowledge&inputs=%5B%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22agent-knowledge-mcp%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=agent-knowledge&inputs=%5B%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22agent-knowledge-mcp%22%5D%7D&quality=insiders)
**Other AI Assistants** - Add similar configuration:
```json
{
"mcp.servers": {
"agent-knowledge": {
"command": "uvx",
"args": ["agent-knowledge-mcp"]
}
}
}
```
*Note: The server has built-in update mechanisms accessible through admin tools.*
## ️ Capabilities
Agent Knowledge MCP provides **34 powerful tools** across 4 categories:
### 🔍 Elasticsearch Operations (9 tools)
- **Smart Search** - Multi-field queries with boosting and relevance scoring
- **Document Management** - Index, retrieve, update, delete with validation
- **Index Administration** - Create, configure, manage Elasticsearch indices
- **Schema Validation** - Enforce document structure and data types
- **Template Generation** - Auto-create document templates with required fields
### 📁 File System Management (11 tools)
- **File Operations** - Read, write, append, delete, move, copy with safety checks
- **Directory Management** - Create, list, navigate directory structures
- **Path Intelligence** - Relative/absolute path conversion and validation
- **File Discovery** - Search files by name, content, or metadata
- **Cross-Platform** - Windows, macOS, Linux compatibility
### 🎛️ System Administration (11 tools)
- **Configuration Management** - Complete config viewing, modification, and validation with strict schema controls
- **Security Controls** - Access restrictions and path validation
- **Health Monitoring** - System status and Elasticsearch connectivity
- **Auto-Setup** - Intelligent Elasticsearch configuration
- **Environment Management** - Directory permissions and structure
- **Strict Schema Control** - Configurable document validation to prevent unauthorized field additions
- **Server Management** - Check status, upgrade MCP server
### 🔄 Version Control (3 tools)
- **Repository Setup** - Git/SVN initialization with best practices
- **File Tracking** - Intelligent commit with change detection
- **History Access** - Retrieve any previous version of files
- **Multi-VCS** - Support for both Git and SVN workflows
## 💬 Example Prompts to Try
Once everything is set up, try asking your AI:
**Knowledge Discovery:**
> *"Search all indexed documents for information about user authentication and summarize the key points"*
**Document Creation:**
> *"Create a new API documentation template and index it with proper categorization"*
**File Management:**
> *"Find all configuration files in the project and create a backup in the configs directory"*
**Version Control:**
> *"Setup version control for this knowledge base and commit all current documents with proper organization"*
**Content Analysis:**
> *"Analyze all markdown files for outdated information and create a list of files that need updates"*
**Project Documentation:**
> *"Read all README files in subdirectories and create a comprehensive project overview document"*
```mermaid
graph TD
A[AI Assistant] --> B[MCP Server]
B --> C[Elasticsearch Client]
B --> D[File System Handler]
B --> E[Version Control Handler]
B --> F[Document Validator]
C --> G[Elasticsearch Cluster]
D --> H[Local File System]
E --> I[Git/SVN Repository]
F --> J[Schema Validation]
```
**Modern, Modular Design:**
1. **MCP Protocol** - Standard communication with AI assistants
2. **Elasticsearch Integration** - Full-featured search and indexing
3. **File System Safety** - Sandboxed operations with validation
4. **Version Control** - Git/SVN support with intelligent workflows
5. **Document Validation** - Schema enforcement and template generation
## 🔒 Security & Privacy
**Enterprise-grade security**:
- ✅ **Sandboxed Operations** - All file operations restricted to configured directories
- ✅ **Path Validation** - Prevent directory traversal and unauthorized access
- ✅ **Access Controls** - Configurable permissions and restrictions
- ✅ **Audit Trails** - Full logging of operations and changes
- ✅ **No Cloud Dependencies** - Everything runs locally
**Configuration Example:**
```json
{
"security": {
"allowed_base_directory": "/your/safe/directory",
"restrict_file_operations": true,
"log_all_operations": true
}
}
```
## 🛡️ Strict Schema Validation
**NEW: Configurable strict schema validation to prevent unwanted data corruption:**
```json
{
"document_validation": {
"strict_schema_validation": true,
"allow_extra_fields": false,
"required_fields_only": false,
"auto_correct_paths": true
}
}
```
**Features:**
- ✅ **Strict Mode** - Reject documents with extra fields beyond the schema
- ✅ **Flexible Control** - Enable/disable validation per use case
- ✅ **Schema Compliance** - Ensure all documents follow defined structure
- ✅ **Clear Error Messages** - Detailed validation feedback with examples
- ✅ **Backward Compatibility** - Works with existing documents
**Benefits:**
- 🛡️ **Data Integrity** - Prevent agents from adding arbitrary fields
- 📊 **Consistent Structure** - Maintain clean, predictable document schemas
- 🔧 **Easy Management** - Toggle validation modes through configuration
- 🚀 **Production Ready** - Ideal for enterprise knowledge management
**Example validation error:**
```
❌ Document validation failed!
Extra fields not allowed in strict mode: custom_field, extra_data
Allowed fields: id, title, summary, file_path, priority, tags, source_type
```
## 📊 Tool Reference
| Category | Count | Tools |
|----------|-------|-------|
| **Elasticsearch** | 9 | search, index_document, create_index, get_document, delete_document, list_indices, delete_index, validate_document_schema, create_document_template |
| **File System** | 11 | read_file, write_file, append_file, delete_file, move_file, copy_file, list_directory, create_directory, delete_directory, file_info, search_files |
| **Administration** | 11 | get_config, update_config, validate_config, get_allowed_directory, set_allowed_directory, reload_config, setup_elasticsearch, elasticsearch_status, server_status, server_upgrade, server_uninstall |
| **Version Control** | 3 | setup_version_control, commit_file, get_previous_file_version |
**Total: 34 tools** for comprehensive knowledge management!
**Quality Assurance:**
- ✅ **Unit Tests** - All core functionality tested
- ✅ **Integration Tests** - End-to-end workflow validation
- ✅ **Error Handling** - Comprehensive error scenarios covered
- ✅ **Cross-Platform** - Tested on Windows, macOS, Linux
## 🤝 Contributing
Love to have your help making Agent Knowledge MCP even better!
### Quick Development Setup
```bash
git clone https://github.com/yourusername/AgentKnowledgeMCP.git
cd AgentKnowledgeMCP
# Install dependencies
pip install -r requirements.txt
# Run tests
python3 test_file_paths.py
# Start development server
python3 src/server.py
```
### Ways to Contribute
- 🐛 **Report bugs** via [GitHub Issues](https://github.com/yourusername/AgentKnowledgeMCP/issues)
- 💡 **Suggest features** for new tools or capabilities
- 🔧 **Add new tools** or improve existing ones
- 📖 **Improve documentation** and examples
- 🧪 **Test with different AI assistants** and share results
### Development Guidelines
- **Modular Design** - Each tool category in separate handlers
- **Comprehensive Testing** - Test all new functionality
- **Security First** - Validate all inputs and file operations
- **Cross-Platform** - Ensure compatibility across operating systems
## 📝 License
MIT License - see [LICENSE](LICENSE) for details.
## 💖 Contributing & Support
### 🤝 How to Contribute
- 🐛 **Report bugs** via [GitHub Issues](https://github.com/itshare4u/AgentKnowledgeMCP/issues)
- 💡 **Suggest features** for new tools or capabilities
- 🔧 **Submit pull requests** for improvements
- 📖 **Improve documentation** and examples
- 🧪 **Test with different AI assistants** and share feedback
### ☕ Financial Support
If this project saves you time or helps your workflow:
[](https://coff.ee/itshare4u)
[](https://github.com/sponsors/itshare4u)
### 🌟 Special Thanks
- All our amazing contributors and supporters
- The Model Context Protocol community
- Elasticsearch team for their excellent search engine
- Python ecosystem for powerful development tools
---
**Ready to supercharge your AI assistant with comprehensive knowledge management? Get started today! 🚀**
*Transform your AI into a powerful knowledge management system with Elasticsearch search, intelligent file operations, and version control - all in one unified MCP server.*
Raw data
{
"_id": null,
"home_page": null,
"name": "agent-knowledge-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ai, automation, elasticsearch, knowledge-management, mcp",
"author": null,
"author_email": "Agent Knowledge MCP Contributors <contributors@agent-knowledge-mcp.dev>",
"download_url": "https://files.pythonhosted.org/packages/b2/0c/3614ec36b1553abadac2c761b71837ee80835045af34708e335e196bbb21/agent_knowledge_mcp-1.0.28.tar.gz",
"platform": null,
"description": "# Agent Knowledge MCP \ud83d\udd0d\n\n**The complete knowledge management solution** \nPowerful Model Context Protocol server for Elasticsearch integration with comprehensive file management and version control.\n\n[](https://python.org)\n[](https://modelcontextprotocol.io)\n[](https://opensource.org/licenses/MIT)\n[](https://coff.ee/itshare4u)\n[](https://github.com/sponsors/itshare4u)\n\n## \ud83d\ude80 What is Agent Knowledge MCP?\n\nThe most comprehensive MCP server that transforms your AI assistant into a powerful knowledge management system. **The key advantage? It combines everything you need**\u2014Elasticsearch search, file operations, document validation, and version control in one unified solution.\n\n**\ud83d\udd11 Complete Knowledge Management:**\n- \u2705 **Elasticsearch Integration**: Full-featured search, indexing, and document management\n- \u2705 **File System Control**: Comprehensive file operations with cross-platform support\n- \u2705 **Document Validation**: Schema-enforced document structure with strict validation modes\n- \u2705 **Configuration Management**: Complete config control with validation and reloading\n- \u2705 **Version Control**: Git and SVN support with intelligent file tracking\n- \u2705 **Security First**: Sandboxed operations with configurable restrictions\n- \u2705 **Production Ready**: Battle-tested with comprehensive error handling\n\n**\u2728 Key Benefits:**\n- \ud83c\udfaf **34 Powerful Tools**: Everything from search to version control and config management with strict schema validation\n- \ud83d\udd04 **Universal AI Support**: Works with Claude, ChatGPT, Cursor, and any MCP-compatible AI\n- \ud83d\udcca **Smart Document Management**: Auto-validation, templates, and structured data with configurable strict schema control\n- \ud83d\udee1\ufe0f **Enterprise Security**: Path validation, access controls, and audit trails\n- \u26a1 **Zero Dependencies**: Optional Elasticsearch - works standalone for file operations\n\n## \ud83c\udf10 AI Assistant Support\n\nWorks with **any MCP-compatible AI assistant**:\n- \u2705 **Claude Desktop**\n- \u2705 **ChatGPT Plus** (with MCP support)\n- \u2705 **Cursor IDE**\n- \u2705 **Windsurf**\n- \u2705 **VS Code** (with MCP extension)\n- \u2705 **Any MCP client**\n\nPerfect for **developers** who want to automate knowledge management and **teams** who need structured document workflows!\n\n## \ud83c\udfac What You Can Do\n\n**Real workflows you can try today:**\n\n### \ud83d\udcda Knowledge Management\n- **\"Search all documents for information about API authentication and create a comprehensive guide\"**\n- **\"Index this technical document with proper categorization and tags\"**\n- **\"Find all documents related to deployment and generate a deployment checklist\"**\n- **\"Create a new document template for API documentation with required fields\"**\n\n### \ud83d\udcc1 File Operations & Organization\n- **\"Organize all markdown files by category and move them to appropriate directories\"**\n- **\"Read all configuration files and create a settings summary document\"**\n- **\"Find duplicate files in the project and list them for cleanup\"**\n- **\"Create a project structure document listing all important files\"**\n\n### \ud83d\udd04 Version Control & History\n- **\"Setup Git repository for this knowledge base and commit all current documents\"**\n- **\"Check what changes were made to the user manual in the last version\"**\n- **\"Commit these updated API docs with a descriptive message\"**\n- **\"Show me the previous version of this configuration file\"**\n\n### \ud83e\udd16 Development & Documentation\n- **\"Index all code documentation and make it searchable\"**\n- **\"Create a changelog from Git commit history\"**\n- **\"Validate all documents follow our schema requirements\"**\n- **\"Generate project documentation from README files\"**\n\n### \ud83d\udd0d Configuration & Schema Management\n- **\"Update configuration to enable strict schema validation for all documents\"**\n- **\"Show me the current configuration settings and validation rules\"**\n- **\"Validate this configuration before applying it to prevent errors\"**\n- **\"Disable extra fields in documents to enforce strict schema compliance\"**\n### \ud83d\udd0d Advanced Search & Analysis\n- **\"Search across all documents and files for security-related information\"**\n- **\"Find all TODO comments in code files and create a task list\"**\n- **\"Analyze document metadata and generate a content report\"**\n- **\"Search for outdated information and flag it for review\"**\n\n## \u2615 Support This Project\n\nIf you find this MCP server useful, consider supporting its development:\n\n[](https://coff.ee/itshare4u)\n[](https://github.com/sponsors/itshare4u)\n[](https://paypal.me/itshare4u)\n[](https://ko-fi.com/itshare4u)\n\n### \ud83d\udc9d Why Support?\n- \ud83d\ude80 **Faster development** of new features and improvements\n- \ud83d\udc1b **Priority bug fixes** and technical support\n- \ud83d\udcda **Better documentation** and comprehensive tutorials\n- \ud83c\udfaf **Community-requested features** implementation\n- \ud83d\udee1\ufe0f **Enhanced security** and stability updates\n- \ud83c\udf1f **Long-term project sustainability**\n\n### \ud83c\udf81 Sponsor Benefits\n| Tier | Amount | Benefits |\n|------|--------|----------|\n| \u2615 **Coffee** | $5 | Thank you mention in README + priority issue responses |\n| \ud83d\ude80 **Supporter** | $15 | Feature request consideration + early access to updates |\n| \ud83d\udc8e **Sponsor** | $30 | Logo in README + special recognition in releases |\n| \ud83c\udf1f **Gold Sponsor** | $50+ | Custom benefits discussion + direct communication channel |\n\n**Every contribution helps maintain and improve this open-source project! \ud83d\ude4f**\n\n## \u26a1 Quick Start\n\n### 1. Installation\n```bash\n# Install with uvx (recommended)\nuvx agent-knowledge-mcp\n```\n\n### 2. Configuration\n```bash\n# Copy and edit configuration\ncp src/config.json.example src/config.json\nnano src/config.json\n```\n\n### 3. Connect to Your AI Assistant\n\n**Claude Desktop** - Add to `claude_desktop_config.json`:\n```json\n{\n \"mcpServers\": {\n \"agent-knowledge\": {\n \"command\": \"uvx\",\n \"args\": [\"agent-knowledge-mcp\"]\n }\n }\n}\n```\n\n**VS Code** - Quick install buttons:\n\n[](https://insiders.vscode.dev/redirect/mcp/install?name=agent-knowledge&inputs=%5B%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22agent-knowledge-mcp%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=agent-knowledge&inputs=%5B%5D&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22agent-knowledge-mcp%22%5D%7D&quality=insiders)\n\n**Other AI Assistants** - Add similar configuration:\n```json\n{\n \"mcp.servers\": {\n \"agent-knowledge\": {\n \"command\": \"uvx\",\n \"args\": [\"agent-knowledge-mcp\"]\n }\n }\n}\n```\n\n*Note: The server has built-in update mechanisms accessible through admin tools.*\n\n## \ufe0f Capabilities\n\nAgent Knowledge MCP provides **34 powerful tools** across 4 categories:\n\n### \ud83d\udd0d Elasticsearch Operations (9 tools)\n- **Smart Search** - Multi-field queries with boosting and relevance scoring\n- **Document Management** - Index, retrieve, update, delete with validation\n- **Index Administration** - Create, configure, manage Elasticsearch indices\n- **Schema Validation** - Enforce document structure and data types\n- **Template Generation** - Auto-create document templates with required fields\n\n### \ud83d\udcc1 File System Management (11 tools) \n- **File Operations** - Read, write, append, delete, move, copy with safety checks\n- **Directory Management** - Create, list, navigate directory structures\n- **Path Intelligence** - Relative/absolute path conversion and validation\n- **File Discovery** - Search files by name, content, or metadata\n- **Cross-Platform** - Windows, macOS, Linux compatibility\n\n### \ud83c\udf9b\ufe0f System Administration (11 tools)\n- **Configuration Management** - Complete config viewing, modification, and validation with strict schema controls\n- **Security Controls** - Access restrictions and path validation\n- **Health Monitoring** - System status and Elasticsearch connectivity\n- **Auto-Setup** - Intelligent Elasticsearch configuration\n- **Environment Management** - Directory permissions and structure\n- **Strict Schema Control** - Configurable document validation to prevent unauthorized field additions\n- **Server Management** - Check status, upgrade MCP server\n\n### \ud83d\udd04 Version Control (3 tools)\n- **Repository Setup** - Git/SVN initialization with best practices\n- **File Tracking** - Intelligent commit with change detection\n- **History Access** - Retrieve any previous version of files\n- **Multi-VCS** - Support for both Git and SVN workflows\n\n## \ud83d\udcac Example Prompts to Try\n\nOnce everything is set up, try asking your AI:\n\n**Knowledge Discovery:**\n> *\"Search all indexed documents for information about user authentication and summarize the key points\"*\n\n**Document Creation:**\n> *\"Create a new API documentation template and index it with proper categorization\"*\n\n**File Management:**\n> *\"Find all configuration files in the project and create a backup in the configs directory\"*\n\n**Version Control:**\n> *\"Setup version control for this knowledge base and commit all current documents with proper organization\"*\n\n**Content Analysis:**\n> *\"Analyze all markdown files for outdated information and create a list of files that need updates\"*\n\n**Project Documentation:**\n> *\"Read all README files in subdirectories and create a comprehensive project overview document\"*\n\n```mermaid\ngraph TD\n A[AI Assistant] --> B[MCP Server]\n B --> C[Elasticsearch Client]\n B --> D[File System Handler]\n B --> E[Version Control Handler]\n B --> F[Document Validator]\n \n C --> G[Elasticsearch Cluster]\n D --> H[Local File System]\n E --> I[Git/SVN Repository]\n F --> J[Schema Validation]\n```\n\n**Modern, Modular Design:**\n1. **MCP Protocol** - Standard communication with AI assistants\n2. **Elasticsearch Integration** - Full-featured search and indexing\n3. **File System Safety** - Sandboxed operations with validation\n4. **Version Control** - Git/SVN support with intelligent workflows\n5. **Document Validation** - Schema enforcement and template generation\n\n## \ud83d\udd12 Security & Privacy\n\n**Enterprise-grade security**:\n- \u2705 **Sandboxed Operations** - All file operations restricted to configured directories\n- \u2705 **Path Validation** - Prevent directory traversal and unauthorized access\n- \u2705 **Access Controls** - Configurable permissions and restrictions\n- \u2705 **Audit Trails** - Full logging of operations and changes\n- \u2705 **No Cloud Dependencies** - Everything runs locally\n\n**Configuration Example:**\n```json\n{\n \"security\": {\n \"allowed_base_directory\": \"/your/safe/directory\",\n \"restrict_file_operations\": true,\n \"log_all_operations\": true\n }\n}\n```\n\n## \ud83d\udee1\ufe0f Strict Schema Validation\n\n**NEW: Configurable strict schema validation to prevent unwanted data corruption:**\n\n```json\n{\n \"document_validation\": {\n \"strict_schema_validation\": true,\n \"allow_extra_fields\": false,\n \"required_fields_only\": false,\n \"auto_correct_paths\": true\n }\n}\n```\n\n**Features:**\n- \u2705 **Strict Mode** - Reject documents with extra fields beyond the schema\n- \u2705 **Flexible Control** - Enable/disable validation per use case\n- \u2705 **Schema Compliance** - Ensure all documents follow defined structure\n- \u2705 **Clear Error Messages** - Detailed validation feedback with examples\n- \u2705 **Backward Compatibility** - Works with existing documents\n\n**Benefits:**\n- \ud83d\udee1\ufe0f **Data Integrity** - Prevent agents from adding arbitrary fields\n- \ud83d\udcca **Consistent Structure** - Maintain clean, predictable document schemas\n- \ud83d\udd27 **Easy Management** - Toggle validation modes through configuration\n- \ud83d\ude80 **Production Ready** - Ideal for enterprise knowledge management\n\n**Example validation error:**\n```\n\u274c Document validation failed!\nExtra fields not allowed in strict mode: custom_field, extra_data\nAllowed fields: id, title, summary, file_path, priority, tags, source_type\n```\n\n## \ud83d\udcca Tool Reference\n\n| Category | Count | Tools |\n|----------|-------|-------|\n| **Elasticsearch** | 9 | search, index_document, create_index, get_document, delete_document, list_indices, delete_index, validate_document_schema, create_document_template |\n| **File System** | 11 | read_file, write_file, append_file, delete_file, move_file, copy_file, list_directory, create_directory, delete_directory, file_info, search_files |\n| **Administration** | 11 | get_config, update_config, validate_config, get_allowed_directory, set_allowed_directory, reload_config, setup_elasticsearch, elasticsearch_status, server_status, server_upgrade, server_uninstall |\n| **Version Control** | 3 | setup_version_control, commit_file, get_previous_file_version |\n\n**Total: 34 tools** for comprehensive knowledge management!\n\n**Quality Assurance:**\n- \u2705 **Unit Tests** - All core functionality tested\n- \u2705 **Integration Tests** - End-to-end workflow validation\n- \u2705 **Error Handling** - Comprehensive error scenarios covered\n- \u2705 **Cross-Platform** - Tested on Windows, macOS, Linux\n\n## \ud83e\udd1d Contributing\n\nLove to have your help making Agent Knowledge MCP even better!\n\n### Quick Development Setup\n```bash\ngit clone https://github.com/yourusername/AgentKnowledgeMCP.git\ncd AgentKnowledgeMCP\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run tests\npython3 test_file_paths.py\n\n# Start development server\npython3 src/server.py\n```\n\n### Ways to Contribute\n- \ud83d\udc1b **Report bugs** via [GitHub Issues](https://github.com/yourusername/AgentKnowledgeMCP/issues)\n- \ud83d\udca1 **Suggest features** for new tools or capabilities\n- \ud83d\udd27 **Add new tools** or improve existing ones\n- \ud83d\udcd6 **Improve documentation** and examples\n- \ud83e\uddea **Test with different AI assistants** and share results\n\n### Development Guidelines\n- **Modular Design** - Each tool category in separate handlers\n- **Comprehensive Testing** - Test all new functionality\n- **Security First** - Validate all inputs and file operations\n- **Cross-Platform** - Ensure compatibility across operating systems\n\n\n## \ud83d\udcdd License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## \ud83d\udc96 Contributing & Support\n\n### \ud83e\udd1d How to Contribute\n- \ud83d\udc1b **Report bugs** via [GitHub Issues](https://github.com/itshare4u/AgentKnowledgeMCP/issues)\n- \ud83d\udca1 **Suggest features** for new tools or capabilities\n- \ud83d\udd27 **Submit pull requests** for improvements\n- \ud83d\udcd6 **Improve documentation** and examples\n- \ud83e\uddea **Test with different AI assistants** and share feedback\n\n### \u2615 Financial Support\nIf this project saves you time or helps your workflow:\n\n[](https://coff.ee/itshare4u)\n[](https://github.com/sponsors/itshare4u)\n\n### \ud83c\udf1f Special Thanks\n- All our amazing contributors and supporters\n- The Model Context Protocol community\n- Elasticsearch team for their excellent search engine\n- Python ecosystem for powerful development tools\n\n---\n\n**Ready to supercharge your AI assistant with comprehensive knowledge management? Get started today! \ud83d\ude80**\n\n*Transform your AI into a powerful knowledge management system with Elasticsearch search, intelligent file operations, and version control - all in one unified MCP server.*\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A comprehensive MCP server for AI knowledge management with Elasticsearch, file operations, and version control",
"version": "1.0.28",
"project_urls": {
"Buy Me Coffee": "https://coff.ee/itshare4u",
"Changelog": "https://github.com/itshare4u/AgentKnowledgeMCP/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/itshare4u/AgentKnowledgeMCP#readme",
"Funding": "https://github.com/sponsors/itshare4u",
"Homepage": "https://github.com/itshare4u/AgentKnowledgeMCP",
"Issues": "https://github.com/itshare4u/AgentKnowledgeMCP/issues",
"Repository": "https://github.com/itshare4u/AgentKnowledgeMCP"
},
"split_keywords": [
"ai",
" automation",
" elasticsearch",
" knowledge-management",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "86b09525e490c69afdc93a72f5f721a9be33acd6605e90990e65e638beb15abf",
"md5": "aa8c4e3bdea0536fe697ad30e6071b8a",
"sha256": "c032c7a963ea6411ddb37c13f10999bf85883d075555329194c1daef4cc92c76"
},
"downloads": -1,
"filename": "agent_knowledge_mcp-1.0.28-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aa8c4e3bdea0536fe697ad30e6071b8a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 61464,
"upload_time": "2025-07-13T08:33:25",
"upload_time_iso_8601": "2025-07-13T08:33:25.630314Z",
"url": "https://files.pythonhosted.org/packages/86/b0/9525e490c69afdc93a72f5f721a9be33acd6605e90990e65e638beb15abf/agent_knowledge_mcp-1.0.28-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b20c3614ec36b1553abadac2c761b71837ee80835045af34708e335e196bbb21",
"md5": "842a0f2a2e4c16e743334198f7ef91c7",
"sha256": "148fe5e6fe3fd85bef7ae521a173778e0ab099d06e4abb782ee1cd63aa0a7ab1"
},
"downloads": -1,
"filename": "agent_knowledge_mcp-1.0.28.tar.gz",
"has_sig": false,
"md5_digest": "842a0f2a2e4c16e743334198f7ef91c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 71854,
"upload_time": "2025-07-13T08:33:31",
"upload_time_iso_8601": "2025-07-13T08:33:31.226471Z",
"url": "https://files.pythonhosted.org/packages/b2/0c/3614ec36b1553abadac2c761b71837ee80835045af34708e335e196bbb21/agent_knowledge_mcp-1.0.28.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-13 08:33:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "itshare4u",
"github_project": "AgentKnowledgeMCP",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "mcp",
"specs": [
[
">=",
"1.10.1"
]
]
},
{
"name": "elasticsearch",
"specs": [
[
">=",
"7.0.0"
],
[
"<",
"8.0.0"
]
]
},
{
"name": "docker",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.32.0"
]
]
}
],
"lcname": "agent-knowledge-mcp"
}
JSON
