mcp-use 1.3.10__tar.gz → 1.3.12__tar.gz

mcp_use-1.3.12/.github/workflows/docs.yml

@@ -0,0 +1,108 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    name: Generate and validate API documentation
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Install uv
+      run: pip install uv
+
+    - name: Create virtual environment
+      run: uv venv
+
+    - name: Install dependencies
+      run: uv pip install -e .
+
+    - name: Install Mintlify CLI
+      run: npm install -g mint
+
+    - name: Generate API documentation
+      run: cd docs && uv run python generate_docs.py ../mcp_use api-reference docs.json
+
+    - name: Check for broken links
+      run: |
+        cd docs
+        mint broken-links
+
+    - name: Check for documentation changes
+      id: check_docs
+      run: |
+        if [ -n "$(git status --porcelain docs/)" ]; then
+          echo "docs_outdated=true" >> $GITHUB_OUTPUT
+          echo "❌ API documentation is out of date!"
+          echo ""
+          echo "The following files have been modified:"
+          MODIFIED=$(git status --porcelain docs/)
+          echo "$MODIFIED"
+          echo "modified_files<<EOF" >> $GITHUB_OUTPUT
+          echo "$MODIFIED" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        else
+          echo "docs_outdated=false" >> $GITHUB_OUTPUT
+          echo "✅ API documentation is up to date"
+        fi
+
+    - name: Comment on PR
+      if: steps.check_docs.outputs.docs_outdated == 'true' && github.event_name == 'pull_request'
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const comment = `## ❌ API Documentation Out of Date
+
+          The API documentation needs to be regenerated. Please run the following commands:
+
+          \`\`\`bash
+          cd docs
+          uv run python generate_docs.py ../mcp_use api-reference docs.json
+          \`\`\`
+
+          Then commit the changes:
+
+          \`\`\`bash
+          git add docs/api-reference/ docs/docs.json
+          git commit -m "docs: update API documentation"
+          \`\`\`
+
+          <details>
+          <summary>Modified files</summary>
+
+          \`\`\`
+          ${process.env.MODIFIED_FILES}
+          \`\`\`
+          </details>`;
+
+          github.rest.issues.createComment({
+            issue_number: context.issue.number,
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: comment
+          });
+      env:
+        MODIFIED_FILES: ${{ steps.check_docs.outputs.modified_files }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Fail if docs are outdated
+      if: steps.check_docs.outputs.docs_outdated == 'true'
+      run: |
+        echo "Please update the API documentation and commit the changes."
+        exit 1

{mcp_use-1.3.10 → mcp_use-1.3.12}/.github/workflows/tests.yml

@@ -77,7 +77,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        primitive: [sampling, tools, resources, prompts, elicitation, notifications]
+        primitive: [sampling, tools, resources, prompts, elicitation, notifications, auth]
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python 3.11

{mcp_use-1.3.10 → mcp_use-1.3.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.10
+Version: 1.3.12
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -15,14 +15,16 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
 Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: authlib>=1.6.3
 Requires-Dist: jsonschema-pydantic>=0.1.0
 Requires-Dist: langchain>=0.1.0
 Requires-Dist: mcp>=1.10.0
 Requires-Dist: posthog>=4.8.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-core==2.33.2
+Requires-Dist: pydantic==2.11.10
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: scarf-sdk>=0.1.0
-Requires-Dist: websockets>=12.0
+Requires-Dist: websockets>=15.0
 Provides-Extra: anthropic
 Requires-Dist: langchain-anthropic; extra == 'anthropic'
 Provides-Extra: dev
@@ -52,12 +54,6 @@ Description-Content-Type: text/markdown
   </picture>
 </div>
 
-<div align="center">
-  <h2>🎉 <strong>We're LIVE on Product Hunt!</strong> 🎉</h2>
-  <p><strong>Support us today and help us reach #1!</strong></p>
-  <a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 220px; height: 54px;" width="250" height="54" /></a>
-  <p>👆 <em>Click to upvote and leave a comment!</em></p>
-</div>
 
 <h1 align="center">🚀 Create MCP Clients and Agents</h1>
 <p align="center">
@@ -96,7 +92,7 @@ Description-Content-Type: text/markdown
 
 | Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
+| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-authentication&label=Authentication&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
 | **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 
 ## Features
@@ -254,14 +250,14 @@ For other settings, models, and more, check out the documentation.
 
 ## Streaming Agent Output
 
-MCP-Use supports asynchronous streaming of agent output using the `astream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
+MCP-Use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
 
 ### How to use
 
-Call `agent.astream(query)` and iterate over the results asynchronously:
+Call `agent.stream(query)` and iterate over the results asynchronously:
 
 ```python
-async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+async for chunk in agent.stream("Find the best restaurant in San Francisco"):
     print(chunk["messages"], end="", flush=True)
 ```
 
@@ -281,7 +277,7 @@ async def main():
     client = MCPClient.from_config_file("browser_mcp.json")
     llm = ChatOpenAI(model="gpt-4o")
     agent = MCPAgent(llm=llm, client=client, max_steps=30)
-    async for chunk in agent.astream("Look for job at nvidia for machine learning engineer."):
+    async for chunk in agent.stream("Look for job at nvidia for machine learning engineer."):
         print(chunk["messages"], end="", flush=True)
 
 if __name__ == "__main__":
@@ -838,31 +834,31 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
-    <td>⭐ 17384</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 131</td>
+    <td>⭐ 18021</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
-    <td>⭐ 100</td>
+    <td>⭐ 202</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-python"><strong>hud-evals/hud-python</strong></a></td>
-    <td>⭐ 78</td>
+    <td>⭐ 168</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
+    <td>⭐ 138</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 64</td>
+    <td>⭐ 74</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>
-    <td>⭐ 35</td>
+    <td>⭐ 40</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 30</td>
+    <td>⭐ 29</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
@@ -874,7 +870,7 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 19</td>
+    <td>⭐ 20</td>
   </tr>
 </table>
 

{mcp_use-1.3.10 → mcp_use-1.3.12}/README.md

@@ -7,12 +7,6 @@
   </picture>
 </div>
 
-<div align="center">
-  <h2>🎉 <strong>We're LIVE on Product Hunt!</strong> 🎉</h2>
-  <p><strong>Support us today and help us reach #1!</strong></p>
-  <a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 220px; height: 54px;" width="250" height="54" /></a>
-  <p>👆 <em>Click to upvote and leave a comment!</em></p>
-</div>
 
 <h1 align="center">🚀 Create MCP Clients and Agents</h1>
 <p align="center">
@@ -51,7 +45,7 @@
 
 | Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
+| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-authentication&label=Authentication&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
 | **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 
 ## Features
@@ -209,14 +203,14 @@ For other settings, models, and more, check out the documentation.
 
 ## Streaming Agent Output
 
-MCP-Use supports asynchronous streaming of agent output using the `astream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
+MCP-Use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
 
 ### How to use
 
-Call `agent.astream(query)` and iterate over the results asynchronously:
+Call `agent.stream(query)` and iterate over the results asynchronously:
 
 ```python
-async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+async for chunk in agent.stream("Find the best restaurant in San Francisco"):
     print(chunk["messages"], end="", flush=True)
 ```
 
@@ -236,7 +230,7 @@ async def main():
     client = MCPClient.from_config_file("browser_mcp.json")
     llm = ChatOpenAI(model="gpt-4o")
     agent = MCPAgent(llm=llm, client=client, max_steps=30)
-    async for chunk in agent.astream("Look for job at nvidia for machine learning engineer."):
+    async for chunk in agent.stream("Look for job at nvidia for machine learning engineer."):
         print(chunk["messages"], end="", flush=True)
 
 if __name__ == "__main__":
@@ -793,31 +787,31 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
-    <td>⭐ 17384</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 131</td>
+    <td>⭐ 18021</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
-    <td>⭐ 100</td>
+    <td>⭐ 202</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-python"><strong>hud-evals/hud-python</strong></a></td>
-    <td>⭐ 78</td>
+    <td>⭐ 168</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
+    <td>⭐ 138</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 64</td>
+    <td>⭐ 74</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>
-    <td>⭐ 35</td>
+    <td>⭐ 40</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 30</td>
+    <td>⭐ 29</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
@@ -829,7 +823,7 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 19</td>
+    <td>⭐ 20</td>
   </tr>
 </table>
 

{mcp_use-1.3.10 → mcp_use-1.3.12}/docs/advanced/building-custom-agents.mdx

@@ -40,7 +40,8 @@ The `LangChainAdapter` is a powerful component that converts MCP tools to LangCh
 
 Here's a simple example of creating a custom agent using the LangChain adapter:
 
-```python
+<CodeGroup>
+```python Python
 import asyncio
 from langchain_openai import ChatOpenAI
 from langchain.agents import AgentExecutor, create_tool_calling_agent
@@ -84,14 +85,66 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+```typescript TypeScript
+import { ChatOpenAI } from '@langchain/openai'
+import { AgentExecutor, createToolCallingAgent } from 'langchain/agents'
+import { ChatPromptTemplate, MessagesPlaceholder } from '@langchain/core/prompts'
+import { MCPClient, LangChainAdapter, loadConfigFile } from 'mcp-use'
+
+async function main() {
+    // Initialize the MCP client
+    const config = await loadConfigFile('path/to/config.json')
+    const client = new MCPClient(config)
+
+    // Create adapter instance
+    const adapter = new LangChainAdapter()
+
+    // Get LangChain tools directly from the client with a single line
+    const tools = await adapter.createTools(client)
+
+    // Initialize your language model
+    const llm = new ChatOpenAI({ model: 'gpt-4o' })
+
+    // Create a prompt template
+    const prompt = ChatPromptTemplate.fromMessages([
+        ['system', 'You are a helpful assistant with access to powerful tools.'],
+        new MessagesPlaceholder('chat_history'),
+        ['human', '{input}'],
+        new MessagesPlaceholder('agent_scratchpad'),
+    ])
+
+    // Create the agent
+    const agent = createToolCallingAgent({ llm, tools, prompt })
+
+    // Create the agent executor
+    const agentExecutor = new AgentExecutor({ agent, tools, verbose: true })
+
+    // Run the agent
+    const result = await agentExecutor.invoke({ input: 'What can you do?' })
+    console.log(result.output)
+
+    await client.closeAllSessions()
+}
+
+main().catch(console.error)
+```
+</CodeGroup>
+
 <Tip>
 **One-Line Tool Creation**: The API simplifies tool creation - all you need is to create an adapter instance and call its `create_tools` method:
 
-```python
+<CodeGroup>
+```python Python
 adapter = LangChainAdapter()
 tools = await adapter.create_tools(client)
 ```
 
+```typescript TypeScript
+const adapter = new LangChainAdapter()
+const tools = await adapter.createTools(client)
+```
+</CodeGroup>
+
 You don't need to worry about sessions, connectors, or initialization. The adapter handles everything for you.
 </Tip>
 
@@ -163,7 +216,8 @@ class YourFrameworkAdapter(BaseAdapter):
 
 Once you've implemented your adapter, you can use it with the simplified API:
 
-```python
+<CodeGroup>
+```python Python
 from your_module import YourFrameworkAdapter
 from mcp_use.client import MCPClient
 
@@ -180,37 +234,56 @@ tools = await adapter.create_tools(client)
 agent = your_framework.create_agent(tools=tools)
 ```
 
+```typescript TypeScript
+import { YourFrameworkAdapter } from './your-module'
+import { MCPClient, loadConfigFile } from 'mcp-use'
+
+// Initialize the client
+const config = await loadConfigFile('config.json')
+const client = new MCPClient(config)
+
+// Create an adapter instance
+const adapter = new YourFrameworkAdapter()
+
+// Get tools with a single line
+const tools = await adapter.createTools(client)
+
+// Use the tools with your framework
+const agent = yourFramework.createAgent({ tools })
+```
+</CodeGroup>
+
 ### Tips for Implementing an Adapter
 
-<Accordion title="Implementation Guidelines">
-  <AccordionItem title="Schema Conversion">
+<AccordionGroup>
+  <Accordion title="Schema Conversion">
     Most frameworks have their own way of handling argument schemas. You'll need to convert the MCP tool's JSON Schema to your framework's format.
 
     <Tip>
     Look at the LangChain adapter implementation as a reference for handling schema conversion patterns.
     </Tip>
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="Tool Execution">
+  <Accordion title="Tool Execution">
     When a tool is called in your framework, you'll need to pass the call to the connector's `call_tool` method and handle the result.
 
     <Warning>
     Always ensure proper async/await handling when calling MCP tools, as they are inherently asynchronous.
     </Warning>
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="Result Parsing">
+  <Accordion title="Result Parsing">
     MCP tools return structured data with types like text, images, or embedded resources. Your adapter should parse these into a format your framework understands.
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="Error Handling">
+  <Accordion title="Error Handling">
     Ensure your adapter handles errors gracefully, both during tool conversion and execution.
 
     <Note>
     The base adapter provides logging utilities to help with error reporting and debugging.
     </Note>
-  </AccordionItem>
-</Accordion>
+  </Accordion>
+</AccordionGroup>
 
 
 ## Conclusion

{mcp_use-1.3.10 → mcp_use-1.3.12}/docs/advanced/logging.mdx

@@ -57,7 +57,8 @@ There are two primary ways to enable debug mode:
 Programmatic control is useful for debugging specific parts of your application or conditionally enabling debug mode based on your application state.
 </Note>
 
-```python
+<CodeGroup>
+```python Python
 import mcp_use
 
 # Different debug levels
@@ -66,16 +67,36 @@ mcp_use.set_debug(2)  # DEBUG level (full verbose output)
 mcp_use.set_debug(0)  # Turn off debug (WARNING level)
 ```
 
+```typescript TypeScript
+import { logger } from 'mcp-use'
+
+// Set the logger level
+logger.level = 'info'   // INFO level
+logger.level = 'debug'  // DEBUG level (full verbose output)
+logger.level = 'warn'   // Turn off debug (WARNING level)
+```
+</CodeGroup>
+
 <Tip>
 You can conditionally enable debugging based on environment or configuration:
 
-```python
+<CodeGroup>
+```python Python
 import os
 import mcp_use
 
 if os.getenv("ENVIRONMENT") == "development":
     mcp_use.set_debug(2)
 ```
+
+```typescript TypeScript
+import { logger } from 'mcp-use'
+
+if (process.env.ENVIRONMENT === 'development') {
+    logger.level = 'debug'
+}
+```
+</CodeGroup>
 </Tip>
 
 ## Debug Levels
@@ -110,7 +131,8 @@ if os.getenv("ENVIRONMENT") == "development":
 
 If you only want to increase verbosity for the agent component without enabling full debug mode for the entire package, you can use the `verbose` parameter when creating an MCPAgent:
 
-```python
+<CodeGroup>
+```python Python
 from mcp_use import MCPAgent
 
 # Create agent with increased verbosity
@@ -121,6 +143,18 @@ agent = MCPAgent(
 )
 ```
 
+```typescript TypeScript
+import { MCPAgent } from 'mcp-use'
+
+// Create agent with increased verbosity
+const agent = new MCPAgent({
+    llm: yourLlm,
+    client: yourClient,
+    verbose: true  // Only shows debug messages from the agent
+})
+```
+</CodeGroup>
+
 This option is useful when you want to see the agent's steps and decision-making process without all the low-level debug information from other components.
 
 ## Debug Information