AIM MCP

🚀 AIM Guard MCP

🛡️ AIM MCP Server :: MCPとAIエージェントを保護します

このサーバーは、AIを活用したセキュリティ分析と安全指示ツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。様々な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

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

🚀 デプロイ

このプロジェクトは、NPMへのシームレスなデプロイのために自動化されたCI/CDパイプラインを使用しています。

自動デプロイ

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トークンの設定

自動デプロイを有効にするには、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

❤️ 作成: AIM Intelligence