Agentknowledgemcp

🚀 Agent Knowledge MCP 🔍

Agent Knowledge MCP是一個強大的模型上下文協議（MCP）服務器，它將AI助手轉變為全面的知識管理系統。該系統集成了Elasticsearch搜索、文件操作、文檔驗證和版本控制等功能，為用戶提供一站式知識管理解決方案。

🚀 快速開始

1. 安裝

# 使用uvx安裝（推薦）
uvx agent-knowledge-mcp

2. 配置

# 複製並編輯配置文件
cp src/config.json.example src/config.json
nano src/config.json

3. 連接到你的AI助手

Claude Desktop - 添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "agent-knowledge": {
      "command": "uvx",
      "args": ["agent-knowledge-mcp"]
    }
  }
}

VS Code - 快速安裝按鈕：

其他AI助手 - 添加類似配置：

{
  "mcp.servers": {
    "agent-knowledge": {
      "command": "uvx",
      "args": ["agent-knowledge-mcp"]
    }
  }
}

注意：服務器內置了可通過管理工具訪問的更新機制。

✨ 主要特性

全面的知識管理

• ✅ Elasticsearch集成：具備全功能的搜索、索引和文檔管理能力。
• ✅ 文件系統控制：支持全面的文件操作，具備跨平臺兼容性。
• ✅ 文檔驗證：通過嚴格的驗證模式，確保文檔結構符合規範。
• ✅ 配置管理：對配置進行全面控制，包括驗證和重新加載。
• ✅ 版本控制：支持Git和SVN，實現智能文件跟蹤。
• ✅ 安全至上：採用沙箱操作和可配置的限制，保障系統安全。
• ✅ 生產就緒：經過嚴格測試，具備完善的錯誤處理機制。

關鍵優勢

• 🎯 34個強大工具：涵蓋從搜索到版本控制和配置管理的所有功能，並具備嚴格的模式驗證。
• 🔄 通用AI支持：可與Claude、ChatGPT、Cursor等任何支持MCP的AI配合使用。
• 📊 智能文檔管理：支持自動驗證、模板生成和結構化數據，可通過配置實現嚴格的模式控制。
• 🛡️ 企業級安全：包括路徑驗證、訪問控制和審計跟蹤。
• ⚡ 零依賴：可選的Elasticsearch集成，可獨立進行文件操作。

🌐 AI助手支持

該系統可與任何支持MCP的AI助手配合使用：

• ✅ Claude Desktop
• ✅ ChatGPT Plus （需支持MCP）
• ✅ Cursor IDE
• ✅ Windsurf
• ✅ VS Code （需安裝MCP擴展）
• ✅ 任何MCP客戶端

非常適合希望自動化知識管理的開發者和需要結構化文檔工作流程的團隊！

🎬 可實現的功能

📚 知識管理

• “搜索所有文檔，查找有關API認證的信息，並創建一份全面的指南”
• “對這份技術文檔進行正確分類和標記，並建立索引”
• “查找所有與部署相關的文檔，並生成一份部署清單”
• “創建一個包含必填字段的API文檔模板”

📁 文件操作與組織

• “按類別組織所有Markdown文件，並將它們移動到相應的目錄中”
• “讀取所有配置文件，並創建一份設置摘要文檔”
• “查找項目中的重複文件，並列出以便清理”
• “創建一份列出所有重要文件的項目結構文檔”

🔄 版本控制與歷史記錄

• “為這個知識庫設置Git倉庫，並提交所有當前文檔”
• “查看上一版本中用戶手冊的更改內容”
• “使用描述性信息提交這些更新後的API文檔”
• “顯示此配置文件的上一個版本”

🤖 開發與文檔編寫

• “為所有代碼文檔建立索引，使其可搜索”
• “根據Git提交歷史記錄創建變更日誌”
• “驗證所有文檔是否符合我們的模式要求”
• “從README文件生成項目文檔”

🔍 配置與模式管理

• “更新配置，為所有文檔啟用嚴格的模式驗證”
• “顯示當前的配置設置和驗證規則”
• “在應用此配置之前進行驗證，以防止錯誤”
• “禁用文檔中的額外字段，以確保嚴格遵守模式”

🔍 高級搜索與分析

• “在所有文檔和文件中搜索與安全相關的信息”
• “查找代碼文件中的所有TODO註釋，並創建一個任務列表”
• “分析文檔元數據，並生成一份內容報告”
• “搜索過時信息，並標記以便審核”

☕ 支持本項目

如果您發現這個MCP服務器很有用，請考慮支持其開發：

💝 支持的原因

• 🚀 加快新功能開發：推動新功能和改進的快速實現。
• 🐛 優先修復漏洞：獲得優先的漏洞修復和技術支持。
• 📚 更好的文檔：提供更完善的文檔和全面的教程。
• 🎯 實現社區需求：根據社區需求實現新功能。
• 🛡️ 增強安全性：獲得更強大的安全和穩定性更新。
• 🌟 確保項目可持續性：保障項目的長期發展。

🎁 贊助福利

等級	金額	福利
☕ 咖啡	$5	在README中致謝 + 優先響應問題
🚀 支持者	$15	考慮功能請求 + 提前訪問更新
💎 贊助商	$30	在README中展示標誌 + 在版本發佈中獲得特別認可
🌟 金牌贊助商	$50+	討論定製福利 + 直接溝通渠道

每一份貢獻都有助於維護和改進這個開源項目！🙏

⚡ 工具能力

Agent Knowledge MCP提供了4大類共34個強大的工具：

🔍 Elasticsearch操作（9個工具）

• 智能搜索 - 支持多字段查詢，具備加權和相關性評分功能。
• 文檔管理 - 對文檔進行索引、檢索、更新和刪除，並進行驗證。
• 索引管理 - 創建、配置和管理Elasticsearch索引。
• 模式驗證 - 確保文檔結構和數據類型符合規範。
• 模板生成 - 自動創建包含必填字段的文檔模板。

📁 文件系統管理（11個工具）

• 文件操作 - 對文件進行讀取、寫入、追加、刪除、移動和複製，並進行安全檢查。
• 目錄管理 - 創建、列出和導航目錄結構。
• 路徑智能 - 實現相對/絕對路徑轉換和驗證。
• 文件發現 - 根據文件名、內容或元數據搜索文件。
• 跨平臺支持 - 兼容Windows、macOS和Linux。

🎛️ 系統管理（11個工具）

• 配置管理 - 全面查看、修改和驗證配置，具備嚴格的模式控制。
• 安全控制 - 實施訪問限制和路徑驗證。
• 健康監測 - 監控系統狀態和Elasticsearch連接性。
• 自動設置 - 智能配置Elasticsearch。
• 環境管理 - 管理目錄權限和結構。
• 嚴格模式控制 - 通過配置防止未經授權的字段添加。
• 服務器管理 - 檢查狀態、升級MCP服務器。

🔄 版本控制（3個工具）

• 倉庫設置 - 按照最佳實踐初始化Git/SVN倉庫。
• 文件跟蹤 - 智能提交，自動檢測文件更改。
• 歷史訪問 - 檢索文件的任何先前版本。
• 多版本控制系統支持 - 支持Git和SVN工作流程。

💬 可嘗試的示例提示

設置完成後，您可以向您的AI嘗試以下問題：

知識發現

“搜索所有已索引的文檔，查找有關用戶認證的信息，並總結關鍵點”

文檔創建

“創建一個新的API文檔模板，並進行正確分類和索引”

文件管理

“查找項目中的所有配置文件，並在configs目錄中創建備份”

版本控制

“為這個知識庫設置版本控制，並以合理的組織方式提交所有當前文檔”

內容分析

“分析所有Markdown文件，查找過時信息，並列出需要更新的文件”

項目文檔編寫

“讀取所有子目錄中的README文件，並創建一份全面的項目概述文檔”

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]

現代模塊化設計

1. MCP協議 - 與AI助手進行標準通信。
2. Elasticsearch集成 - 提供全功能的搜索和索引服務。
3. 文件系統安全 - 通過驗證實現沙箱操作。
4. 版本控制 - 支持Git/SVN，具備智能工作流程。
5. 文檔驗證 - 確保文檔符合模式要求，支持模板生成。

🔒 安全與隱私

企業級安全

• ✅ 沙箱操作 - 所有文件操作限制在配置的目錄內。
• ✅ 路徑驗證 - 防止目錄遍歷和未經授權的訪問。
• ✅ 訪問控制 - 可配置的權限和限制。
• ✅ 審計跟蹤 - 對所有操作和更改進行全面記錄。
• ✅ 無雲依賴 - 所有操作均在本地運行。

配置示例

{
  "security": {
    "allowed_base_directory": "/your/safe/directory",
    "restrict_file_operations": true,
    "log_all_operations": true
  }
}

🛡️ 嚴格的模式驗證

新增功能：可配置的嚴格模式驗證，防止數據損壞

{
  "document_validation": {
    "strict_schema_validation": true,
    "allow_extra_fields": false,
    "required_fields_only": false,
    "auto_correct_paths": true
  }
}

特性

• ✅ 嚴格模式 - 拒絕包含模式外額外字段的文檔。
• ✅ 靈活控制 - 根據不同用例啟用或禁用驗證。
• ✅ 模式合規 - 確保所有文檔遵循定義的結構。
• ✅ 清晰的錯誤信息 - 提供詳細的驗證反饋和示例。
• ✅ 向後兼容 - 與現有文檔兼容。

優勢

• 🛡️ 數據完整性 - 防止代理添加任意字段。
• 📊 一致的結構 - 保持文檔模式的清晰和可預測性。
• 🔧 易於管理 - 通過配置切換驗證模式。
• 🚀 生產就緒 - 非常適合企業級知識管理。

示例驗證錯誤

❌ 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

📊 工具參考

類別	數量	工具
Elasticsearch	9	search, index_document, create_index, get_document, delete_document, list_indices, delete_index, validate_document_schema, create_document_template
文件系統	11	read_file, write_file, append_file, delete_file, move_file, copy_file, list_directory, create_directory, delete_directory, file_info, search_files
系統管理	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
版本控制	3	setup_version_control, commit_file, get_previous_file_version

總共34個工具，實現全面的知識管理！

質量保證

• ✅ 單元測試 - 對所有核心功能進行測試。
• ✅ 集成測試 - 驗證端到端工作流程。
• ✅ 錯誤處理 - 覆蓋所有常見錯誤場景。
• ✅ 跨平臺測試 - 在Windows、macOS和Linux上進行測試。

🤝 貢獻

我們非常歡迎您的幫助，讓Agent Knowledge MCP變得更加出色！

快速開發設置

git clone https://github.com/yourusername/AgentKnowledgeMCP.git
cd AgentKnowledgeMCP

# 安裝依賴
pip install -r requirements.txt

# 運行測試
python3 test_file_paths.py

# 啟動開發服務器
python3 src/server.py

貢獻方式

• 🐛 報告漏洞：通過 GitHub問題 提交。
• 💡 提出功能建議：為新工具或功能提供想法。
• 🔧 添加新工具或改進現有工具：提交代碼。
• 📖 改進文檔和示例：提高文檔質量。
• 🧪 使用不同的AI助手進行測試：並分享測試結果。

開發指南

• 模塊化設計 - 每個工具類別使用單獨的處理程序。
• 全面測試 - 對所有新功能進行測試。
• 安全第一 - 對所有輸入和文件操作進行驗證。
• 跨平臺兼容 - 確保在不同操作系統上均可正常工作。

📝 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

💖 貢獻與支持

🤝 如何貢獻

• 🐛 報告漏洞：通過 GitHub問題 提交。
• 💡 提出功能建議：為新工具或功能提供想法。
• 🔧 提交拉取請求：進行改進。
• 📖 改進文檔和示例：提高文檔質量。
• 🧪 使用不同的AI助手進行測試：並分享反饋。

☕ 財務支持

如果這個項目節省了您的時間或改善了您的工作流程，請考慮提供財務支持：

🌟 特別感謝

• 所有優秀的貢獻者和支持者
• 模型上下文協議社區
• Elasticsearch團隊提供的優秀搜索引擎
• Python生態系統提供的強大開發工具

---

準備好通過全面的知識管理為您的AI助手賦能了嗎？立即開始吧！🚀

通過Elasticsearch搜索、智能文件操作和版本控制，將您的AI轉變為強大的知識管理系統 - 所有功能都集成在一個統一的MCP服務器中。