Aim MCP

🚀 AIM Guard MCP

🛡️ AIM MCP Server :: AIモデルやエージェントの保護とセキュリティ対策

このModel Context Protocol (MCP) サーバーは、AIを活用したセキュリティ分析と安全ガイドラインを提供するツールです。様々なMCPや外部サービスとのやり取りにおいて、AIエージェントを保護するためのセキュリティガイドライン、コンテンツ分析、注意事項を提供します。

🚀 クイックスタート

AIM Guard MCPは、AIエージェントのセキュリティを強化するためのMCPサーバーです。以下の手順で簡単に導入できます。

✨ 主な機能

• 🛡️ 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

他のMCPとのやり取り前に、AIエージェントにコンテキストセキュリティガイドラインと注意事項を提供します。

{
  "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への公開：バージョンが変更されている場合、自動的に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トークンの設定

自動デプロイを有効にするには、GitHub SecretsにNPMトークンを追加します。

1. npmjs.comにアクセスし、自動化トークンを作成します。
2. GitHubリポジトリで、Settings > Secrets and variables > Actionsに移動します。
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

Made with ❤️ by AIM Intelligence