Cloudwatch Logs MCP

🚀 CloudWatch日誌MCP服務器

CloudWatch日誌MCP服務器是一個提供工具以訪問AWS CloudWatch日誌的MCP（模型上下文協議）服務器。它允許AI助手列出CloudWatch日誌組，並從AWS CloudWatch讀取日誌條目，為日誌管理和分析提供了便利。

🚀 快速開始

在使用該服務器前，需要確保已配置好AWS憑證，可通過AWS CLI或設置環境變量AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY來完成配置。之後根據自身需求，選擇與Claude Desktop一起使用或者使用Docker運行服務器。

✨ 主要特性

• 日誌組管理：提供list_groups工具，可列出可用的CloudWatch日誌組。
• 日誌讀取：提供get_logs工具，能從特定日誌組中獲取CloudWatch日誌。
• 靈活配置：支持通過AWS CLI、環境變量、Claude Desktop配置文件以及Docker容器等多種方式進行配置。

📦 安裝指南

AWS憑證

確保已配置AWS憑證。您可以使用AWS CLI或通過設置環境變量來配置：

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY

與Claude Desktop一起使用

將以下內容添加到您的claude_desktop_config.json文件中：

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "python3",
      "args": ["/path/to/cloudwatch-logs-mcp/main.py"],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Docker

如果您更願意在Docker容器中運行服務器，可以設置一個Dockerfile並使用以下配置：

{
  "mcpServers": {
    "cloudwatch-logs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/cloudwatch-logs"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
      }
    }
  }
}

💻 使用示例

基礎用法

list_groups

列出可用的CloudWatch日誌組：

# 調用list_groups工具
# 此處假設存在調用該工具的函數
result = list_groups()
print(result)

get_logs

從特定日誌組中獲取CloudWatch日誌：

# 調用get_logs工具
# 此處假設存在調用該工具的函數
result = get_logs(logGroupName='your_log_group_name')
print(result)

高級用法

list_groups

列出特定前綴和區域的CloudWatch日誌組：

# 調用list_groups工具，指定前綴和區域
# 此處假設存在調用該工具的函數
result = list_groups(prefix='your_prefix', region='your_region')
print(result)

get_logs

從特定日誌組和日誌流中，在指定時間範圍內獲取過濾後的CloudWatch日誌：

# 調用get_logs工具，指定日誌組、日誌流、時間範圍和過濾模式
# 此處假設存在調用該工具的函數
result = get_logs(logGroupName='your_log_group_name', logStreamName='your_log_stream_name', startTime='2024-01-01T00:00:00Z', endTime='2024-01-02T00:00:00Z', filterPattern='your_filter_pattern')
print(result)

📚 詳細文檔

可用工具

list_groups

列出可用的CloudWatch日誌組。 參數：

返回值：包含logGroupName、creationTime和storedBytes的JSON字符串。

get_logs

從特定日誌組中獲取CloudWatch日誌。 參數：

返回值：包含timestamp、message和logStreamName的JSON字符串。

🔧 技術細節

此服務器使用MCP SDK中的FastMCP類構建，該類提供了一種簡單的方式來創建MCP服務器。服務器主要公開了兩個工具：

1. list_groups：列出可用的CloudWatch日誌組
2. get_logs：從特定的日誌組中讀取日誌條目

每個工具都實現了為@mcp.tool()裝飾的異步函數。服務器使用boto3庫與AWS服務進行交互。

📄 許可證

本項目採用MIT許可證。