MCP Use

🚀 MCP-Use 使用ガイド

MCP-Useは、MCPサービスを簡単に利用するためのツールです。PythonからMCPサービスを呼び出し、各種ツールを使用することができます。

🚀 クイックスタート

📦 インストール

pip install mcp-use

🔛 始める

以下のコードで簡単に始めることができます。

import asyncio
from mcp_use.client import MCPClient
from mcp_use.adapters.langchain_adapter import LangChainAdapter
from dotenv import load_dotenv

load_dotenv()

async def main():
    client = MCPClient.from_config_file("examples/browser_mcp.json")
    adapter = LangChainAdapter()
    tools = await adapter.create_tools(client)
    
    # 创建一个绑定工具的LLM
    llm_with_tools = llm.bind_tools(tools)
    result = await llm_with_tools.ainvoke("你能使用什么工具？")
    print(result)

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

💻 使用例

基本的な使用法

import asyncio
from mcp_use.client import MCPClient
from langchain_openai import ChatOpenAI

async def main():
    client = MCPClient.from_config_files(
        config_files=["config1.json", "config2.json"]
    )
    
    # 创建代理
    async with client:
        llm = ChatOpenAI(model="gpt-4")
        tools = await client.get_tools()
        
        # 使用所有可用工具
        result = await llm.invoke("你能做什么？", tools=tools)
        print(result)

asyncio.run(main())

高度な使用法

複数のMCPサービスを使用する

import asyncio
from mcp_use.client import MCPClient
from langchain_openai import ChatOpenAI

async def main():
    client = MCPClient.from_config_files(
        config_files=["config1.json", "config2.json"]
    )
    
    # 创建代理
    async with client:
        llm = ChatOpenAI(model="gpt-4")
        tools = await client.get_tools()
        
        # 使用所有可用工具
        result = await llm.invoke("你能做什么？", tools=tools)
        print(result)

asyncio.run(main())

HTTPでMCPサービスに接続する

import asyncio
from mcp_use.client import MCPClient
from langchain_openai import ChatOpenAI

async def main():
    client = MCPClient.from_url("ws://localhost:3000/ws")
    
    async with client:
        llm = ChatOpenAI(model="gpt-4")
        tools = await client.get_tools()
        
        result = await llm.invoke("你能使用什么工具？", tools=tools)
        print(result)

asyncio.run(main())

カスタムアダプターを使用する

import asyncio
from mcp_use.client import MCPClient, BaseMCPAdapter
from typing import Any

class CustomAdapter(BaseMCPAdapter):
    async def get_action(self, observation: Any) -> str:
        # 实现自定义逻辑
        pass
    
async def main():
    client = MCPClient.from_config_file("config.json")
    
    adapter = CustomAdapter()
    async with client:
        action = await adapter.get_action("观察结果")
        print(action)

asyncio.run(main())

📚 ドキュメント

クライアントAPI

• MCPClient：複数のMCPサービス接続を管理します。
• BaseMCPAdapter：異なるMCP実装とのインターフェースを定義します。

ツールの例

from mcp_use.tools import (
    Tool,
    BrowserTool,
    FileSystemTool,
    DatabaseTool,
    SearchEngineTool
)

🔧 高度な機能

並列実行

import asyncio
from mcp_use.client import MCPClient
from langchain_openai import ChatOpenAI

async def main():
    client = MCPClient.from_config_file("config.json")
    
    async with client:
        # 创建多个任务
        tasks = []
        for i in range(5):
            task = asyncio.create_task(client.request(f"第{i+1}个请求"))
            tasks.append(task)
        
        # 等待所有任务完成
        results = await asyncio.gather(*tasks)
        print(results)

asyncio.run(main())

ツールセットの拡張

from mcp_use import Tool

class CustomTool(Tool):
    def __init__(self, custom_param: str):
        super().__init__()
        self.custom_param = custom_param
    
    async def execute(self, command: str) -> str:
        # 自定义逻辑
        return f"自定义工具执行结果：{command}"

🐞 デバッグとトラブルシューティング

デバッグログの有効化

export MCP_USE_DEBUG=1

一般的な問題

• 接続問題：ネットワークとターゲットサービスの状態を確認してください。
• 権限問題：リソースにアクセスするのに十分な権限があることを確認してください。

🤝 プロジェクトへの貢献

コードの提出

1. リポジトリをForkします。
2. 新しいブランチを作成します。
3. 変更をコミットします。
4. リモートにPushします。
5. Pull Requestを提出します。

👥 コミュニティサポート

コミュニティDiscordに参加しましょう。

https://discord.gg/example

📄 ライセンス

MIT ライセンス

👨‍💻 貢献者

• 開発者：[あなたの名前]
• 貢献者リスト：[contributor1], [contributor2]