Agentknowledgemcp

🚀 Agent Knowledge MCP 🔍

完全な知識管理ソリューションです。Elasticsearchと統合された強力なModel Context Protocolサーバーで、包括的なファイル管理とバージョン管理が可能です。

🚀 クイックスタート

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検索、インテリジェントなファイル操作、およびバージョン管理を備えた、すべてが1つの統一されたMCPサーバーで動作する強力な知識管理システムにAIを変えましょう。