Log Analyzer With MCP

🚀 日誌分析器與MCP

本項目是一個基於模型上下文協議（MCP）的服務器，它能為AI助手提供對AWS CloudWatch日誌的訪問權限，可用於日誌的分析、搜索和關聯等操作。

🚀 快速開始

前提準備

要使用本項目，您需要滿足以下條件：

• 安裝uv Python包和項目管理器。
• 擁有一個帶有CloudWatch日誌的AWS賬戶。
• 按照此處說明配置好AWS憑證。

安裝步驟

# 克隆倉庫
git clone https://github.com/awslabs/Log-Analyzer-with-MCP.git
cd Log-Analyzer-with-MCP

# 創建虛擬環境並安裝依賴項
uv sync
source .venv/bin/activate  # 在Windows上使用`.venv\Scripts\activate`

快速上手

1. 確保已按照此處描述配置好AWS憑證。
2. 更新您的claude_desktop_config.json文件，使其符合AI集成指南中所述的正確配置。
3. 打開Claude桌面版並開始聊天！

若您想了解更多示例和高級用法，請參閱詳細使用指南。

✨ 主要特性

• 檢查和搜索CloudWatch日誌組。
• 使用CloudWatch日誌見解查詢語法搜索日誌。
• 生成日誌摘要並識別錯誤模式。
• 在多個AWS服務之間關聯日誌。
• 為Claude等助手優化的AI工具。

詳細功能列表

📦 安裝指南

先決條件

• uv Python包和項目管理器。
• 帶有CloudWatch日誌的AWS賬戶。
• 配置好的AWS憑證。

設置

# 克隆倉庫
git clone https://github.com/awslabs/Log-Analyzer-with-MCP.git
cd Log-Analyzer-with-MCP

# 創建虛擬環境並安裝依賴項
uv sync
source .venv/bin/activate  # 在Windows上使用`.venv\Scripts\activate`

🏗️ 架構

🔌 模型上下文協議（MCP）

如Anthropic所述：

MCP是一個開放協議，標準化AI應用程序為LLM提供上下文的方式。想象一下，MCP就像一個USB - C端口用於AI應用程序。就像USB - C以統一的方式將您的設備連接到各種外圍設備和配件一樣，MCP以統一的方式將AI模型與不同的數據源和工具連接起來。

此倉庫是一個示例客戶端和服務器，允許像Claude這樣的AI助手訪問AWS賬戶中的CloudWatch日誌。如需瞭解更多信息，請閱讀簡介。

🤖 AI 集成

該項目可以輕鬆集成到像Claude桌面版這樣的AI助手中。請參考AI集成指南瞭解詳細信息。

📚 詳細文檔

• 詳細功能
• 使用指南
• AWS配置
• 架構細節
• AI集成
• 故障排除

🔧 技術細節

此項目基於模型上下文協議（MCP）構建，通過該協議為AI助手提供對AWS CloudWatch日誌的訪問權限。它利用了uv Python包和項目管理器來管理項目依賴和虛擬環境，同時藉助AWS賬戶的CloudWatch日誌服務進行日誌的分析、搜索和關聯等操作。項目的架構圖展示了其整體的結構和組件之間的關係，方便開發者理解和進一步開發。

🔒 安全

有關更多信息，請參閱CONTRIBUTING。

📄 許可證

該項目根據Apache - 2.0許可證發佈。