Agentknowledgemcp

🚀 Agent Knowledge MCP 🔍

Agent Knowledge MCPは、AIアシスタントを強力な知識管理システムに変える、最も包括的なMCPサーバーです。Elasticsearch検索、ファイル操作、ドキュメント検証、バージョン管理など、必要な機能をすべて統合した一元的なソリューションです。

🚀 クイックスタート

1. インストール

# uvxを使ってインストールする（推奨）
uvx agent-knowledge-mcp

2. 設定

# 設定ファイルをコピーして編集する
cp src/config.json.example src/config.json
nano src/config.json

3. AIアシスタントへの接続

Claude Desktop - claude_desktop_config.jsonに追加する:

{
  "mcpServers": {
    "agent-knowledge": {
      "command": "uvx",
      "args": ["agent-knowledge-mcp"]
    }
  }
}

VS Code - クイックインストールボタン:

その他のAIアシスタント - 同様の設定を追加する:

{
  "mcp.servers": {
    "agent-knowledge": {
      "command": "uvx",
      "args": ["agent-knowledge-mcp"]
    }
  }
}

注: サーバーには、管理ツールを通じてアクセスできる組み込みの更新メカニズムがあります。

✨ 主な機能

🔑 完全な知識管理

• ✅ Elasticsearch統合: 充実した検索、インデックス作成、ドキュメント管理機能
• ✅ ファイルシステム制御: クロスプラットフォーム対応の包括的なファイル操作
• ✅ ドキュメント検証: 厳格な検証モードでスキーマに準拠したドキュメント構造
• ✅ 設定管理: 検証と再読み込み機能を備えた完全な設定管理
• ✅ バージョン管理: GitとSVNをサポートし、インテリジェントなファイル追跡機能
• ✅ セキュリティ第一: 設定可能な制限を持つサンドボックス化された操作
• ✅ 本番環境対応: 包括的なエラーハンドリングで実戦検証済み

✨ 主な利点

• 🎯 34の強力なツール: 検索からバージョン管理、設定管理まで、厳格なスキーマ検証を備えたすべての機能
• 🔄 汎用AIサポート: Claude、ChatGPT、Cursor、およびMCP互換のすべてのAIで動作
• 📊 スマートなドキュメント管理: 自動検証、テンプレート、構造化データ、設定可能な厳格なスキーマ制御
• 🛡️ エンタープライズセキュリティ: パス検証、アクセス制御、監査証跡
• ⚡ 依存関係ゼロ: オプションのElasticsearch - ファイル操作には単独で動作

🌐 AIアシスタントサポート

MCP互換のすべてのAIアシスタントで動作します:

• ✅ Claude Desktop
• ✅ ChatGPT Plus (MCPサポート付き)
• ✅ Cursor IDE
• ✅ Windsurf
• ✅ VS Code (MCP拡張機能付き)
• ✅ すべてのMCPクライアント

知識管理を自動化したい開発者や、構造化されたドキュメントワークフローが必要なチームに最適です！

🎬 できること

今すぐ試せる実際のワークフロー:

📚 知識管理

• 「API認証に関する情報をすべてのドキュメントから検索し、包括的なガイドを作成する」
• 「この技術ドキュメントを適切に分類してタグ付けしてインデックス化する」
• 「デプロイに関連するすべてのドキュメントを見つけ、デプロイチェックリストを生成する」
• 「APIドキュメント用の新しいドキュメントテンプレートを作成し、必要なフィールドを設定する」

📁 ファイル操作と整理

• 「すべてのMarkdownファイルをカテゴリ別に整理し、適切なディレクトリに移動する」
• 「すべての設定ファイルを読み取り、設定の要約ドキュメントを作成する」
• 「プロジェクト内の重複ファイルを見つけ、削除のためにリストアップする」
• 「すべての重要なファイルをリストしたプロジェクト構造ドキュメントを作成する」

🔄 バージョン管理と履歴

• 「この知識ベースのGitリポジトリをセットアップし、現在のすべてのドキュメントをコミットする」
• 「前のバージョンでユーザーマニュアルに加えられた変更を確認する」
• 「これらの更新されたAPIドキュメントを説明的なメッセージ付きでコミットする」
• 「この設定ファイルの前のバージョンを表示する」

🤖 開発とドキュメント作成

• 「すべてのコードドキュメントをインデックス化し、検索可能にする」
• 「Gitのコミット履歴から変更履歴を作成する」
• 「すべてのドキュメントがスキーマ要件に従っていることを検証する」
• 「READMEファイルからプロジェクトドキュメントを生成する」

🔍 設定とスキーマ管理

• 「すべてのドキュメントに対して厳格なスキーマ検証を有効にするように設定を更新する」
• 「現在の設定と検証ルールを表示する」
• 「この設定を適用する前に検証し、エラーを防ぐ」
• 「ドキュメント内の余分なフィールドを無効にし、厳格なスキーマ準拠を強制する」

🔍 高度な検索と分析

• 「すべてのドキュメントとファイルからセキュリティ関連の情報を検索する」
• 「コードファイル内のすべてのTODOコメントを見つけ、タスクリストを作成する」
• 「ドキュメントのメタデータを分析し、コンテンツレポートを生成する」
• 「古い情報を検索し、見直しのためにフラグを立てる」

☕ このプロジェクトをサポートする

このMCPサーバーが役に立つと思ったら、開発をサポートすることを検討してください:

💝 サポートする理由

• 🚀 新機能と改善点の開発を加速する
• 🐛 優先的なバグ修正と技術サポート
• 📚 より良いドキュメントと包括的なチュートリアル
• 🎯 コミュニティからの要望に応じた機能の実装
• 🛡️ セキュリティと安定性の向上更新
• 🌟 プロジェクトの長期的な持続可能性

🎁 スポンサー特典

すべての貢献が、このオープンソースプロジェクトの維持と改善に役立ちます！🙏

️ 機能

Agent Knowledge MCPは、4つのカテゴリにわたる34の強力なツールを提供します:

🔍 Elasticsearch操作 (9つのツール)

• スマート検索 - ブーストと関連性スコア付けを備えた多フィールドクエリ
• ドキュメント管理 - 検証付きのインデックス作成、取得、更新、削除
• インデックス管理 - Elasticsearchインデックスの作成、設定、管理
• スキーマ検証 - ドキュメント構造とデータ型の強制
• テンプレート生成 - 必要なフィールドを持つドキュメントテンプレートの自動作成

📁 ファイルシステム管理 (11つのツール)

• ファイル操作 - 安全チェック付きの読み取り、書き込み、追加、削除、移動、コピー
• ディレクトリ管理 - ディレクトリ構造の作成、一覧表示、ナビゲーション
• パスインテリジェンス - 相対/絶対パスの変換と検証
• ファイル検索 - 名前、内容、またはメタデータでファイルを検索
• クロスプラットフォーム - Windows、macOS、Linux互換

🎛️ システム管理 (11つのツール)

• 設定管理 - 厳格なスキーマ制御を備えた完全な設定の表示、変更、検証
• セキュリティ制御 - アクセス制限とパス検証
• ヘルスモニタリング - システムの状態とElasticsearchの接続性
• 自動セットアップ - インテリジェントなElasticsearch設定
• 環境管理 - ディレクトリのパーミッションと構造
• 厳格なスキーマ制御 - 許可されていないフィールドの追加を防ぐための設定可能なドキュメント検証
• サーバー管理 - 状態の確認、MCPサーバーのアップグレード

🔄 バージョン管理 (3つのツール)

• リポジトリセットアップ - ベストプラクティスに基づくGit/SVNの初期化
• ファイル追跡 - 変更検出付きのインテリジェントなコミット
• 履歴アクセス - ファイルの過去の任意のバージョンを取得
• 複数のVCS - GitとSVNの両方のワークフローをサポート

💬 試してみるサンプルプロンプト

すべての設定が完了したら、AIに以下の質問を試してみてください:

知識発見:

「すべてのインデックス化されたドキュメントからユーザー認証に関する情報を検索し、要点を要約する」

ドキュメント作成:

「新しいAPIドキュメントテンプレートを作成し、適切に分類してインデックス化する」

ファイル管理:

「プロジェクト内のすべての設定ファイルを見つけ、configsディレクトリにバックアップを作成する」

バージョン管理:

「この知識ベースのバージョン管理をセットアップし、現在のすべてのドキュメントを適切に整理してコミットする」

コンテンツ分析:

「すべてのMarkdownファイルを分析し、古い情報を探し、更新が必要なファイルのリストを作成する」

プロジェクトドキュメント:

「サブディレクトリ内のすべてのREADMEファイルを読み取り、包括的なプロジェクト概要ドキュメントを作成する」

graph TD
    A[AI Assistant] --> B[MCP Server]
    B --> C[Elasticsearch Client]
    B --> D[File System Handler]
    B --> E[Version Control Handler]
    B --> F[Document Validator]
    
    C --> G[Elasticsearch Cluster]
    D --> H[Local File System]
    E --> I[Git/SVN Repository]
    F --> J[Schema Validation]

モダンでモジュール化された設計:

1. MCPプロトコル - AIアシスタントとの標準的な通信
2. Elasticsearch統合 - 充実した検索とインデックス作成機能
3. ファイルシステムの安全性 - 検証付きのサンドボックス化された操作
4. バージョン管理 - インテリジェントなワークフローを備えたGit/SVNサポート
5. ドキュメント検証 - スキーマの強制とテンプレート生成

🔒 セキュリティとプライバシー

エンタープライズグレードのセキュリティ:

• ✅ サンドボックス化された操作 - すべてのファイル操作は設定されたディレクトリに制限されます
• ✅ パス検証 - ディレクトリトラバーサルと不正アクセスを防止します
• ✅ アクセス制御 - 設定可能なパーミッションと制限
• ✅ 監査証跡 - すべての操作と変更の完全なログ
• ✅ クラウド依存性なし - すべてがローカルで実行されます

設定例:

{
  "security": {
    "allowed_base_directory": "/your/safe/directory",
    "restrict_file_operations": true,
    "log_all_operations": true
  }
}

🛡️ 厳格なスキーマ検証

新機能: 望ましくないデータ破損を防ぐための設定可能な厳格なスキーマ検証:

{
  "document_validation": {
    "strict_schema_validation": true,
    "allow_extra_fields": false,
    "required_fields_only": false,
    "auto_correct_paths": true
  }
}

特徴:

• ✅ 厳格モード - スキーマ外の余分なフィールドを持つドキュメントを拒否します
• ✅ 柔軟な制御 - ユースケースごとに検証を有効/無効にできます
• ✅ スキーマ準拠 - すべてのドキュメントが定義された構造に従っていることを保証します
• ✅ 明確なエラーメッセージ - 例付きの詳細な検証フィードバック
• ✅ 下位互換性 - 既存のドキュメントと互換性があります

利点:

• 🛡️ データの整合性 - エージェントが任意のフィールドを追加するのを防ぎます
• 📊 一貫した構造 - きれいで予測可能なドキュメントスキーマを維持します
• 🔧 簡単な管理 - 設定を通じて検証モードを切り替えることができます
• 🚀 本番環境対応 - エンタープライズの知識管理に最適です

検証エラーの例:

❌ Document validation failed!
Extra fields not allowed in strict mode: custom_field, extra_data
Allowed fields: id, title, summary, file_path, priority, tags, source_type

📊 ツールリファレンス

合計: 34のツールで包括的な知識管理を実現します！

品質保証:

• ✅ 単体テスト - すべてのコア機能がテストされています
• ✅ 統合テスト - エンドツーエンドのワークフローの検証
• ✅ エラーハンドリング - 包括的なエラーシナリオがカバーされています
• ✅ クロスプラットフォーム - Windows、macOS、Linuxでテストされています

🤝 コントリビュートする

Agent Knowledge MCPをさらに良くするためのあなたの助けが嬉しいです！

クイック開発セットアップ

git clone https://github.com/yourusername/AgentKnowledgeMCP.git
cd AgentKnowledgeMCP

# 依存関係のインストール
pip install -r requirements.txt

# テストの実行
python3 test_file_paths.py

# 開発サーバーの起動
python3 src/server.py

コントリビュートする方法

• 🐛 GitHub Issuesを通じてバグを報告する
• 💡 新しいツールや機能の提案をする
• 🔧 新しいツールを追加するか、既存のツールを改善する
• 📖 ドキュメントとサンプルを改善する
• 🧪 さまざまなAIアシスタントでテストし、結果を共有する

開発ガイドライン

• モジュール化された設計 - 各ツールカテゴリを別々のハンドラーに分ける
• 包括的なテスト - すべての新機能をテストする
• セキュリティ第一 - すべての入力とファイル操作を検証する
• クロスプラットフォーム - すべてのオペレーティングシステムで互換性があることを確認する

📝 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

💖 コントリビュートとサポート

🤝 コントリビュートする方法

• 🐛 GitHub Issuesを通じてバグを報告する
• 💡 新しいツールや機能の提案をする
• 🔧 改善のためのプルリクエストを送信する
• 📖 ドキュメントとサンプルを改善する
• 🧪 さまざまなAIアシスタントでテストし、フィードバックを共有する

☕ 資金的なサポート

このプロジェクトがあなたの時間を節約したり、ワークフローを支援したりした場合:

🌟 特別な感謝

• 素敵なすべてのコントリビューターとサポーター
• Model Context Protocolコミュニティ
• 優れた検索エンジンを提供してくれたElasticsearchチーム
• 強力な開発ツールを提供してくれたPythonエコシステム

包括的な知識管理でAIアシスタントを強化する準備はできましたか？今すぐ始めましょう！🚀

Elasticsearch検索、インテリジェントなファイル操作、バージョン管理を備えた一元的なMCPサーバーで、あなたのAIを強力な知識管理システムに変えましょう。