Langchain Box MCP Adapter

🚀 langchain-box-mcp-adapter

本示例項目實現了Langchain MCP適配器與Box MCP服務器的集成。它展示瞭如何藉助工具和代理，將Langchain與Box MCP服務器進行整合。

🚀 快速開始

此示例項目實現了Langchain MCP適配器與Box MCP服務器的集成。您可以按以下步驟開始使用：

1. 克隆倉庫：

   git clone <repository-url>
   cd langchain-box-mcp-adapter
   

2. 安裝依賴：

   uv sync
   

3. 在項目根目錄中創建一個.env文件並填寫信息：

LANGSMITH_TRACING = "true"
LANGSMITH_API_KEY =
OPENAI_API_KEY =

BOX_CLIENT_ID = ""
BOX_CLIENT_SECRET = ""
BOX_SUBJECT_TYPE = "user"
BOX_SUBJECT_ID = ""

4. 確保MCP服務器已設置並可在項目指定路徑下訪問。
5. 更新src/simple_client.py或src/graph.py中的StdioServerParameters，使用正確的路徑到您的MCP服務器腳本：

    server_params = StdioServerParameters(
        command="uv",
        args=[
            "--directory",
            "/your/absolute/path/to/the/mcp/server/mcp-server-box",
            "run",
            "src/mcp_server_box.py",
        ],
    )

運行簡單客戶端

要運行簡單客戶端，可執行以下命令：

uv run src/simple_client.py

這將啟動一個基於控制檯的應用程序，您可以在其中與AI代理交互。輸入提示詞，代理將使用工具和AI功能進行響應。

運行基於圖的代理（LangGraph）

通過調用src/graph.py中的make_graph函數可以使用基於圖的代理，執行以下命令：

uv run langgraph dev --config src/langgraph.json

您應該會看到類似以下的內容：

✨ 主要特性

• Langchain 集成：利用Langchain的ChatOpenAI模型進行AI交互。
• MCP 服務器通信：通過stdio傳輸連接到Box MCP服務器。
• 工具加載：從MCP服務器動態加載工具。
• 代理創建：創建一個基於React風格的代理來處理用戶提示和工具交互。
• 豐富控制檯輸出：提供用戶友好的控制檯界面，支持Markdown渲染和打字機效果。

📦 安裝指南

環境要求

• Python 3.13或更高版本
• 列出在pyproject.toml中的依賴：
  • langchain-mcp-adapters>=0.0.8
  • langchain-openai>=0.3.12
  • langgraph>=0.3.29
  • rich>=14.0.0

安裝步驟

1. 克隆倉庫：

   git clone <repository-url>
   cd langchain-box-mcp-adapter
   

2. 安裝依賴：

   uv sync
   

3. 在項目根目錄中創建一個.env文件並填寫信息：

LANGSMITH_TRACING = "true"
LANGSMITH_API_KEY =
OPENAI_API_KEY =

BOX_CLIENT_ID = ""
BOX_CLIENT_SECRET = ""
BOX_SUBJECT_TYPE = "user"
BOX_SUBJECT_ID = ""

4. 確保MCP服務器已設置並可在項目指定路徑下訪問。
5. 更新src/simple_client.py或src/graph.py中的StdioServerParameters，使用正確的路徑到您的MCP服務器腳本：

    server_params = StdioServerParameters(
        command="uv",
        args=[
            "--directory",
            "/your/absolute/path/to/the/mcp/server/mcp-server-box",
            "run",
            "src/mcp_server_box.py",
        ],
    )

📚 詳細文檔

項目結構

• src/simple_client.py：主程序入口點。
• src/graph.py：包含基於圖的代理設置。
• src/console_utils/console_app.py：用於控制檯交互的實用函數。
• src/langgraph.json：LangGraph集成的配置文件。

📄 許可證

該項目使用MIT許可證。有關詳細信息，請參閱LICENSE文件。

💡 貢獻說明

歡迎貢獻！請打開問題或提交Pull Request以進行任何改進或修復。