Langchain MCP Chat Platform

🚀 プロジェクト説明

このプロジェクトは、特定の機能を提供するアプリケーションで、Google Gemini、Tavily、Gmail などのサービスとの統合が可能です。

📦 インストール

環境要件

• Python: Python 3.8 以上の使用を推奨します。
• Node.js: Tavily と Gmail サービスを起動する場合、Node.js と npm が必要です。

依存関係のインストール

web_js ディレクトリで必要な Python パッケージをインストールします。

pip install -r requirements.txt

⚙️ 設定

環境変数

.env という名前のファイルを作成し、以下の内容を追加し、実際の API キーに置き換えてください。

GOOGLE_API_KEY=your_api_key_here
SMITHERY_KEY=your_smithery_cli_key_here
TAVILY_API_KEY=your_tavily_api_key_here  # オプション、デフォルトでは SMITHKEY 環境変数を使用
GMAIL_API_KEY=your_gmail_api_key_here    # オプション、デフォルトでは Gmail API キーファイルのパスを使用

▶️ アプリケーションの起動

方法 1: すべての MCP サービスを起動

以下のコマンドを実行して、すべての機能（muhasebe、Tavily 検索、Gmail を含む）を有効にします。

cd web_js
python main.py

方法 2: muhasebe サービスのみを起動（初回使用時に推奨）

初期テストのために、web_js/main.py の Tavily と Gmail サービスの設定をコメントアウトすることができます。

🛠️ トラブルシューティング

アプリケーション起動時の遅延

• 問題：アプリケーションが起動中に応答しない場合があります。
• 解決策：
  1. 基本機能をテストするために、muhasebe サービスのみを起動します。
  2. Node.js と npm が正しくインストールされていることを確認し、npm install -g @smithery/cli を実行します。

パスの問題

• 問題：MCP サーバーのパスが見つからない場合があります。
• 解決策：web_js/main.py で絶対パスを使用して MCP サービスを起動します。例えば：

"args": ["C:/full/path/to/langchain-mcp-chat-platform/own_mcp/mcp_server.py"]

🌐 サードパーティ統合機能

Google Gemini

• 用途：自然言語の理解と生成。
• 設定：GOOGLE_API_KEY が正しく設定されていることを確認してください。

Tavily

• 用途：ウェブ検索とコンテンツ抽出。
• 設定：.env で TAVILY_API_KEY を指定するか、環境変数 SMITHKEY を使用します。

Gmail

• 用途：電子メールの操作と管理。
• 設定：Google Cloud プロジェクトで Gmail API を有効にし、GMAIL_API_KEY を設定します。

⚠️ 注意事項

1. API キーのセキュリティ：
   • .env ファイルを .gitignore に追加し、機密情報の漏洩を防ぎます。
   • .env.example ファイルを確認して、必要な環境変数を取得してください。
2. モジュール化設計：
   • 必要に応じて特定のサービスを無効にすることができます。デフォルトではすべての機能が有効になっています。
3. 言語パッケージのバージョン管理：
   • 互換性を確保するために、langgraph - prebuilt==0.1.5 を使用します。
   • 依存関係を更新する前に十分なテストを行い、バージョンの互換性の問題を避けてください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

📚 コンポーネントの詳細情報

create_react_agent のインポートパス

コードで正しいインポート方法を使用してください。

from langgraph.prebuilt.task import create_react_agent

注意：以下の古いインポート方法を使用するとエラーが発生します。

from langgraph.prebuilt import create_react_agent