AgentKnowledgeMCP

探索

Agentknowledgemcp

Agent Knowledge MCP是一個全面的知識管理解決方案，集成了Elasticsearch搜索、文件操作、文檔驗證和版本控制功能，為AI助手提供強大的知識管理能力。

知識管理與記憶開發者工具 #知識管理 #文件操作 #搜索集成 #版本控制 .Python

評分 : 2.5分

下載量 : 7.4K

更新時間 : 2025-07-28

打開站點

安裝

複製以下命令到你的Client進行配置

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

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 Agent Knowledge MCP 🔍

Agent Knowledge MCP 是一款全面的知識管理解決方案，它是強大的模型上下文協議（MCP）服務器，可與 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"]
    }
  }
}

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

✨ 主要特性

核心優勢

Agent Knowledge MCP 是最全面的 MCP 服務器，它能將你的 AI 助手轉變為強大的知識管理系統。其關鍵優勢在於將你所需的一切功能集於一體，包括 Elasticsearch 搜索、文件操作、文檔驗證和版本控制。

完整的知識管理

✅ 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 助手] --> B[MCP 服務器]
    B --> C[Elasticsearch 客戶端]
    B --> D[文件系統處理程序]
    B --> E[版本控制處理程序]
    B --> F[文檔驗證器]
    
    C --> G[Elasticsearch 集群]
    D --> H[本地文件系統]
    E --> I[Git/SVN 倉庫]
    F --> J[模式驗證]

現代模塊化設計

MCP 協議 - 與 AI 助手進行標準通信。
Elasticsearch 集成 - 全功能搜索和索引。
文件系統安全 - 沙盒操作，具備驗證功能。
版本控制 - 支持 Git/SVN，具備智能工作流。
文檔驗證 - 模式強制實施和模板生成。

🔒 安全與隱私

該系統具備企業級安全特性：

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

配置示例

{
  "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
  }
}

特性

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

優勢

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

示例驗證錯誤

❌ 文檔驗證失敗！
嚴格模式下不允許額外字段：custom_field, extra_data
允許的字段：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