Aim MCP

🚀 AIM Guard MCP

🛡️ AIM MCP 服務器 :: 保護您的 MCP 和 AI 代理

AIM Guard MCP 是一個模型上下文協議（MCP）服務器，提供基於人工智能的安全分析和安全指導工具。該服務器通過提供安全指南、內容分析和警示說明，在與各種 MCP 和外部服務交互時幫助保護 AI 代理。

🚀 快速開始

AIM Guard MCP 是一個強大的工具，能為 AI 代理提供安全保障。您可以按照以下步驟快速使用它。

✨ 主要特性

• 🛡️ AI 安全衛士：在 MCP 交互之前，為 AI 代理提供上下文安全說明和預防措施。
• 🔍 文本防護分析：使用 AIM Intelligence API 分析文本內容，檢測有害或不適當內容。
• 🔒 安全提示增強：在用戶提示中添加安全說明，實現更安全的 AI 交互。
• ⚡ 快速輕量：使用 TypeScript 和 Zod 驗證構建。
• 🔧 易於集成：可與任何兼容 MCP 的 AI 助手配合使用。
• 🔗 API 集成：連接到 AIM Intelligence API 進行高級內容分析。

📦 安裝指南

NPX（推薦）

npx aim-guard-mcp

全局安裝

npm install -g aim-guard-mcp
aim-guard-mcp

本地安裝

npm install aim-guard-mcp

💻 使用示例

基礎用法

作為 MCP 服務器

將以下內容添加到您的 MCP 客戶端配置中：

{
  "servers": {
    "aim-guard": {
      "type": "stdio",
      "command": "npx",
      "args": ["aim-guard-mcp"]
    }
  }
}

高級用法

測試工具

測試 AI 安全衛士

# 獲取數據庫操作的安全說明
{
  "name": "ai-safety-guard",
  "arguments": {
    "mcp_type": "database",
    "operation_type": "query",
    "sensitivity_level": "confidential"
  }
}

測試文本防護

# 分析文本中的有害內容
{
  "name": "aim-text-guard",
  "arguments": {
    "text": "This is a sample text to analyze for safety."
  }
}

測試安全提示增強

# 為用戶提示添加安全說明
{
  "name": "aim-security-prompt-tool",
  "arguments": {
    "user_prompt": "Please help me with this task",
    "security_level": "strict"
  }
}

可用工具

1. ai-safety-guard

在 AI 代理與其他 MCP 交互之前，提供上下文安全說明和預防措施。

{
  "name": "ai-safety-guard",
  "arguments": {
    "mcp_type": "email|slack|database|file|web|general", // 調用的 MCP 類型
    "operation_type": "read|write|execute|delete|send|query", // 執行的操作
    "sensitivity_level": "public|internal|confidential|restricted" // 數據敏感級別
  }
}

特性：

• 基於 MCP 類型的上下文安全指南。
• 特定操作的警告和預防措施。
• 基於數據敏感級別的協議和限制。
• 安全 MCP 交互的綜合清單。
• 危險標誌檢測和中止建議。

2. aim-text-guard

使用 AIM Intelligence API 分析文本內容，檢測有害或不適當內容。

{
  "name": "aim-text-guard",
  "arguments": {
    "text": "Text content to analyze for harmful content"
  }
}

特性：

• 即時內容分析。
• 有害內容檢測。
• 以 JSON 格式呈現的詳細分析結果。
• 帶有詳細信息的錯誤處理。
• 分析請求的時間戳跟蹤。

3. aim-security-prompt-tool

為用戶提示添加安全說明，實現更安全的 AI 交互。

{
  "name": "aim-security-prompt-tool",
  "arguments": {
    "user_prompt": "Original user prompt to enhance",
    "security_level": "basic|standard|strict" // 可選，默認為 'standard'
  }
}

特性：

• 多級安全增強（基本、標準、嚴格）。
• 全面的威脅分析說明。
• 社會工程學防護指南。
• 安全策略合規性檢查。
• 清理和驗證要求。

🔧 技術細節

🛡️ AI 代理保護

• MCP 交互安全：針對不同 MCP 類型的上下文指南。
• 操作驗證：讀寫/執行操作的特定預防措施。
• 數據敏感性處理：基於數據分類級別的協議。

🔍 內容分析

• 即時威脅檢測：分析內容中的有害模式。
• API 驅動的分析：高級 AI 驅動的內容安全評估。
• 綜合報告：詳細的安全分析結果。

🔒 提示安全

• 安全增強提示：在用戶提示中添加保護說明。
• 可配置的安全級別：從基本到嚴格的安全協議。
• 威脅預防：AI 交互中的主動安全措施。

📚 詳細文檔

開發

# 克隆倉庫
git clone https://github.com/AIM-Intelligence/AIM-MCP.git
cd AIM-MCP

# 安裝依賴
pnpm install

# 構建項目
pnpm run build

# 以開發模式運行
pnpm run dev

# 運行測試
pnpm test

部署

本項目使用自動化 CI/CD 管道無縫部署到 NPM。

自動部署

當您推送到 main 分支時，GitHub Actions 將自動執行以下操作：

1. 構建和測試：編譯 TypeScript 並運行測試。
2. 版本檢查：將當前版本與已發佈版本進行比較。
3. 發佈到 NPM：如果版本發生變化，自動發佈。
4. 創建發佈：使用版本標籤生成 GitHub 發佈。

手動版本管理

# 升級補丁版本 (1.0.0 -> 1.0.1)
pnpm run release:patch

# 升級次要版本 (1.0.0 -> 1.1.0)
pnpm run release:minor

# 升級主要版本 (1.0.0 -> 2.0.0)
pnpm run release:major

設置 NPM 令牌

要啟用自動部署，請將您的 NPM 令牌添加到 GitHub 機密中：

1. 訪問 npmjs.com 並創建一個自動化令牌。
2. 在您的 GitHub 倉庫中，轉到“設置”>“機密和變量”>“操作”。
3. 添加一個名為 NPM_TOKEN 的新機密，並將您的 NPM 令牌值添加到其中。

部署工作流

graph LR
    A[Push to main] --> B[GitHub Actions]
    B --> C[Build & Test]
    C --> D[Version Check]
    D --> E{Version Changed?}
    E -->|Yes| F[Publish to NPM]
    E -->|No| G[Skip Deployment]
    F --> H[Create GitHub Release]
    F --> I[Create Git Tag]

📄 許可證

本項目採用 ISC 許可證，請參閱 LICENSE 文件以獲取詳細信息。

支持

• 📧 郵箱：support@aim-intelligence.com
• 🐛 問題反饋：GitHub Issues
• 📖 文檔：GitHub Wiki

由 AIM Intelligence 用心打造 ❤️