AIM MCP

🚀 AIM Guard MCP

🛡️ AIM Guard MCP 是一款基於AI的安全防護工具，為模型上下文協議（MCP）提供安全分析和防護指導。它能在AI代理與各類MCP及外部服務交互時，提供安全指南、內容分析和警示說明，有效保護AI代理的安全。

🚀 快速開始

AIM Guard MCP是一個模型上下文協議（MCP）服務器，提供基於人工智能的安全分析和安全指導工具。該服務器通過在與各種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 Secrets：

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]

🤝 貢獻代碼

1. 分叉倉庫。
2. 創建您的功能分支 (git checkout -b feature/amazing-feature)。
3. 提交您的更改 (git commit -m 'Add some amazing feature')。
4. 推送到該分支 (git push origin feature/amazing-feature)。
5. 打開一個拉取請求。

📄 許可證

本項目採用ISC許可證 - 詳情請參閱 LICENSE 文件。

📞 支持

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

由 AIM Intelligence 用心打造 ❤️