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 用心打造 ❤️