Crewai Adapter

🚀 CrewAI MCP アダプター

CrewAI MCP アダプターは、Python ライブラリです。このライブラリは CrewAI のアダプターエコシステムを拡張し、モデルコンテキストプロトコル (MCP) のサポートを統合し、カスタムエージェントとツール開発のための包括的なツールを提供します。

🚀 クイックスタート

from crewai import Agent, Task
from crewai_adapters import CrewAIAdapterClient
from crewai_adapters.types import AdapterConfig

async def main():
    async with CrewAIAdapterClient() as client:
        # 连接到 MCP 服务器
        await client.connect_to_mcp_server(
            "math",
            command="python",
            args=["math_server.py"]
        )

        # 创建代理及其工具
        agent = Agent(
            name="Calculator",
            goal="执行计算操作",
            tools=client.get_tools()
        )

        # 执行任务
        task = Task(
            description="计算 (3 + 5) × 12",
            agent=agent
        )
        result = await task.execute()
        print(f"结果: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

✨ 主な機能

• 🔌 CrewAI とのネイティブ統合とアダプターパターン
• 🛠️ MCP プロトコルのサポートによるツール統合
• 🧩 新しいアダプターを拡張および作成するための使いやすいインターフェース
• 📝 Pydantic を使用した型安全な実装
• 🔍 ツールパラメータの JSON Schema 検証
• 🚀 非同期/待機のサポート
• 📊 詳細な実行メタデータ

📦 インストール

このライブラリは、以下の方法でインストールできます。

PyPI からのインストール

pip install crewai-adapters

ソースコードからのインストール

pip install git+https://github.com/dshivendra/crewai_mcp_adapter.git

💻 使用例

基本的な使用法

from crewai import Agent, Task
from crewai_adapters import CrewAIAdapterClient
from crewai_adapters.types import AdapterConfig

async def main():
    async with CrewAIAdapterClient() as client:
        # 连接到 MCP 服务器
        await client.connect_to_mcp_server(
            "math",
            command="python",
            args=["math_server.py"]
        )

        # 创建代理及其工具
        agent = Agent(
            name="Calculator",
            goal="执行计算操作",
            tools=client.get_tools()
        )

        # 执行任务
        task = Task(
            description="计算 (3 + 5) × 12",
            agent=agent
        )
        result = await task.execute()
        print(f"结果: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

📚 ドキュメント

詳細なドキュメントは以下を参照してください。

• 入門ガイド
• API リファレンス
• サンプル

🔧 技術詳細

前提条件

• Python 3.11 以上
• crewai パッケージ
• pydantic パッケージ
• mcp パッケージ

開発用依存関係のインストール

pip install -e ".[test,docs]"

テストの実行

pytest tests/ -v

🔄 リリース

新しいバージョンを PyPI にリリースするには、以下の手順を実行します。

1. pyproject.toml のバージョン番号を更新します。
2. パッケージをビルドします。

   python -m build
   

3. PyPI にアップロードします。

   python -m twine upload dist/*
   

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🌟 貢献

貢献を歓迎します！自由に Pull Request を送信してください。