MCP To Langchain Addapter

🚀 MCPからLangChainとLangGraphへのアダプタードキュメント

MCPからLangChainとLangGraphへのアダプターは、MCPプロトコルのツールをLangChainとLangGraphに適合させるためのツールです。このアダプターを使用することで、MCPツールをLangChainやLangGraphの環境で簡単に利用することができます。

🚀 クイックスタート

アダプターの初期化

from mcp_langchain_adapter import MCPAdapter

# MCPサーバースクリプトのパスを指定してアダプターインスタンスを作成
adapter = MCPAdapter(server_script_path="path/to/your/mcp_server.py")

# MCPサーバーへの接続を同期的に初期化
adapter.initialize()

ツールリストの取得

tools = adapter.get_tools()

# 利用可能なツールの情報を表示
print(f"{len(tools)} 個のツールが見つかりました：")
for tool in tools:
    print(f"- {tool.name}: {tool.description}")

ツールの使用例

# 特定の名前のツールを取得
add_tool = adapter.get_tool_by_name("add")

if add_tool:
    # ツールを使用して操作を実行
    result = add_tool.run({"a": 5, "b": 7})
    print(f"加法の結果：{result}")

weather_tool = adapter.get_tool_by_name("get_weather")
if weather_tool:
    result = weather_tool.run({"city": "London"})
    print(f"天気の検索結果：{result}")

📦 インストール

依存関係のインストール

pip install mcp-langchain-adapter

✨ 主な機能

ツールの適合

• MCPプロトコルのツールをLangChainとLangGraph互換のBaseToolクラスに変換します。
• 環境変数を含むカスタムパラメータの渡し方をサポートしています。

サーバーの起動と管理

• MCPサーバープロセスを簡単に起動する方法を提供します。
• 非同期の初期化とリソースのクリーンアップをサポートしています。

💻 使用例

基本的な使用法

from mcp_langchain_adapter import MCPAdapter

adapter = MCPAdapter("path/to/mcp_server.py")
adapter.initialize()

# 利用可能なすべてのツールを取得
tools = adapter.get_tools()
print(f"{len(tools)} 個のツールが検出されました：")

for tool in tools:
    print(f"- 名前: {tool.name}")
    print(f"  説明: {tool.description}")
    print(f"  パラメータ: {tool.args_schema}\n")

高度な使用法

from mcp_langchain_adapter import MCPToolWrapper

# ツールラッパーのインスタンスを作成
wrapper = MCPToolWrapper(
    name="電卓",
    description="基本的な算術演算を実行するツール",
    server_script_path="path/to/calculator_server.py",
    env={"ENV_VAR": "value"},
    args_schema={  # オプションのパラメータ定義
        "a": {"type": "int", "required": True},
        "b": {"type": "int", "required": True}
    }
)

🔧 高度な機能

ツールラッパー

from mcp_langchain_adapter import MCPToolWrapper

# ツールラッパーのインスタンスを作成
wrapper = MCPToolWrapper(
    name="電卓",
    description="基本的な算術演算を実行するツール",
    server_script_path="path/to/calculator_server.py",
    env={"ENV_VAR": "value"},
    args_schema={  # オプションのパラメータ定義
        "a": {"type": "int", "required": True},
        "b": {"type": "int", "required": True}
    }
)

自動検出と発見

• 指定されたディレクトリをスキャンしてMCPツールを自動的に検出します。
• 新しく追加されたツールの動的なロードをサポートしています。

トラブルシューティング

よくある問題

MCPサーバーに接続できません。

• サーバースクリプトのパスが正しいことを確認してください。
• サーバーが実行中で、正しいポートを監視していることを確認してください。

ツールが見つかりません。

• ツールがアダプターの仕様に準拠していることを確認してください。
• 詳細な情報を取得するためにログ出力を確認してください。

環境変数の設定が間違っています。

• envパラメータが正しく渡されていることを確認してください。
• サーバー側でこれらの環境変数を読み取ることができることを確認してください。

ログ記録

# ログ記録を設定
import logging
logging.basicConfig(level=logging.DEBUG)

adapter = MCPAdapter("path/to/mcp_server.py", log_level=logging.DEBUG)

カスタマイズと拡張

カスタムツールのロード

def custom_tool_loader(directory):
    # 指定されたディレクトリを手動でスキャンし、MCPツールのリストを返す
    tools = []
    for script in os.listdir(directory):
        if script.endswith(".py"):
            try:
                tool = MCPToolWrapper(..., server_script_path=os.path.join(directory, script))
                tools.append(tool)
            except Exception as e:
                print(f"スクリプト {script} をロードする際にエラーが発生しました：{e}")
    return tools

adapter = MCPAdapter(custom_tool_loader=custom_tool_loader)

非同期サポート

async def async_usage():
    adapter = MCPAdapter("path/to/mcp_server.py")
    await adapter.initialize()  # 非同期で接続を初期化

    # 非同期ツール呼び出しの例
    result = await add_tool.async_run({"a": 5, "b": 7})
    print(f"非同期加法の結果：{result}")

📚 ドキュメント

追加リソース

• MCPプロトコルの公式ドキュメント
• LangChainコミュニティサポート

貢献ガイド

修正や機能強化の貢献を歓迎します！ このリポジトリをForkし、提出する前にContributing.mdを読んでください。

📄 ライセンス

MIT License

連絡先

• メール：support@mcp-langchain-adapter.com
• GitHub：https://github.com/mcp/langchain-adapter