Multi Capable Processing MCP Smart Agent

マルチ機能処理（MCP）スマートエージェント 専門エージェントを中央の REST API 経由で接続する、モジュール式で拡張可能な AI 駆動型エージェントシステムです。これらのエージェントは、コードリポジトリの分析、外部データ（天気など）の取得、テキストの要約生成、永続メモリーマネージャーを使用した過去のやり取りの記憶を行えます。

---

🚀 主な機能

• マルチエージェントアーキテクチャ： コード分析、データ検索、要約に特化したエージェントを備えたモジュール式の設計です。
• ツール統合型エージェント： 各エージェントは GitHub API、天気サービス、基本的な NLP 技術などのツールを使用します。
• メモリーシステム： 過去のタスクを永続的に記憶し、文脈に応じて呼び出せます。
• RESTful サーバー： HTTP 経由でフロントエンド、CLI ツール、ワークフローと簡単に連携できます。
• Python らしい構成： テストや拡張が容易なプロジェクト構成です。
• スケーリングに対応： OpenAI、LangGraph、ベクトルデータベースなどを追加できます。

---

🗂️ プロジェクト構成

mcp-smart-agent/
│
├── agents/                  # AI agents for specific task domains
│   ├── code_agent.py        # Analyzes GitHub repositories
│   ├── data_agent.py        # Fetches weather data
│   └── summary_agent.py     # Summarizes input text
│
├── tools/                   # External service integrations
│   ├── github_tool.py       # Simulates GitHub API access
│   └── weather_tool.py      # Simulates weather data fetch
│
├── memory/
│   └── memory_manager.py    # In-memory key-value storage (can be extended)
│
├── server/
│   └── mcp_server.py        # Flask API endpoints to interact with all agents
│
├── tests/
│   └── test_agents.py       # Unit tests for core functionality
│
├── main.py                  # Entry point to start the server
├── requirements.txt         # Python dependencies
└── README.md                

---

🧠 仕組み

このシステムは、さまざまなエージェントに対応するエンドポイントを公開する Flask サーバーを起動します。

1. CodeAgent（GitHub リポジトリを分析）

• GitHub のようなリポジトリ（モック）からデータを抽出します。
• 概要レベルの分析結果（ファイル数など）を返します。
• 結果をメモリーに保存します。

2. DataAgent（天気データを取得）

• 場所の入力を受け取ります。
• モックの天気データを返します（OpenWeatherMap などに接続できます）。

3. SummaryAgent（テキスト要約ツール）

• 長文を受け取り、基本的な要約を返します。
• GPT や HuggingFace モデルを使用するよう拡張できます。

4. MemoryManager

• 出力を再利用できるよう保存します。
• シンプルなキーと値によるメモリーに対応しています（Redis やベクトル DB にアップグレードできます）。

---

🔌 API エンドポイント

メソッド	エンドポイント	説明
POST	/analyze_repo	GitHub リポジトリを分析します
POST	/get_weather	モックの天気データを取得します
POST	/summarize	テキストのまとまりを要約します
POST	/retrieve_memory	タスクに保存されたメモリーを取得します

🔧 使用例

curl -X POST http://localhost:5000/analyze_repo \
  -H "Content-Type: application/json" \
  -d '{"repo_url": "https://github.com/example/repo"}'

---

🧪 テスト

次のコマンドで単体テストを実行します。

python -m unittest discover tests

---

🛠 インストールと実行

前提条件

• Python 3.7+
• pip がインストール済みであること

依存関係をインストール

pip install -r requirements.txt

サーバーを起動

python server/mcp_server.py

---

拡張のアイデア

• モックのツールを実際の API（GitHub、OpenWeather、LangChain ツール）に置き換えます。
• Pinecone や ChromaDB などのベクトルデータベースを使用して、永続メモリーを実現します。
• LangGraph を追加して、長時間実行される計画ワークフローに対応します。
• 要約エージェントを GPT-4 または HuggingFace Transformers に置き換えます。
• 認証、ロギング、レート制限を追加します。

🙋‍♂ 作成者

Adad が作成 — 迅速なプロトタイピングと実験のためのオープンソース AI エージェントフレームワークです。