🚀 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 将自动执行以下操作：
- 构建和测试：编译 TypeScript 并运行测试。
- 版本检查：将当前版本与已发布版本进行比较。
- 发布到 NPM：如果版本发生变化，自动发布。
- 创建发布：使用版本标签生成 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 机密中：
- 访问 npmjs.com 并创建一个自动化令牌。
- 在您的 GitHub 仓库中，转到“设置”>“机密和变量”>“操作”。
- 添加一个名为
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 用心打造 ❤️