mcp-use 1.3.2__tar.gz → 1.3.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of mcp-use might be problematic. Click here for more details.

Files changed (154) hide show
  1. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/publish.yml +4 -5
  2. mcp_use-1.3.4/.github/workflows/stale.yml +18 -0
  3. {mcp_use-1.3.2 → mcp_use-1.3.4}/CODE_OF_CONDUCT.md +1 -1
  4. {mcp_use-1.3.2 → mcp_use-1.3.4}/CONTRIBUTING.md +1 -1
  5. {mcp_use-1.3.2 → mcp_use-1.3.4}/PKG-INFO +31 -30
  6. {mcp_use-1.3.2 → mcp_use-1.3.4}/README.md +28 -21
  7. mcp_use-1.3.4/docs/api-reference/mcpagent.mdx +141 -0
  8. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/changelog.mdx +17 -0
  9. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/development/observability.mdx +2 -1
  10. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/docs.json +8 -7
  11. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/connection-types.mdx +2 -2
  12. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/server-manager.mdx +1 -0
  13. mcp_use-1.3.4/docs/guides/streaming.mdx +296 -0
  14. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/mcp_everything.py +1 -1
  15. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/multi_server_example.py +1 -1
  16. mcp_use-1.3.4/examples/stream_example.py +48 -0
  17. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/adapters/base.py +2 -7
  18. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/agents/mcpagent.py +247 -148
  19. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/base.py +3 -6
  20. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/sandbox.py +7 -8
  21. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/search_tools.py +27 -5
  22. {mcp_use-1.3.2 → mcp_use-1.3.4}/pyproject.toml +3 -9
  23. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/sse/test_connection_state_tracking.py +23 -127
  24. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_sandbox_connector.py +3 -3
  25. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_stdio_connector.py +13 -4
  26. mcp_use-1.3.2/docs/api-reference/mcpagent.mdx +0 -29
  27. mcp_use-1.3.2/docs/guides/streaming.mdx +0 -453
  28. mcp_use-1.3.2/tests/integration/servers_for_testing/long_timeout_test_server.py +0 -171
  29. {mcp_use-1.3.2 → mcp_use-1.3.4}/.env.example +0 -0
  30. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  31. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/pull_request_template.md +0 -0
  32. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/release-drafter.yml +0 -0
  33. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/changelog.yml +0 -0
  34. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/claude.yml +0 -0
  35. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/release-drafter.yml +0 -0
  36. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/transportstests.yml +0 -0
  37. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/unittests.yml +0 -0
  38. {mcp_use-1.3.2 → mcp_use-1.3.4}/.github/workflows/update-readme.yml +0 -0
  39. {mcp_use-1.3.2 → mcp_use-1.3.4}/.gitignore +0 -0
  40. {mcp_use-1.3.2 → mcp_use-1.3.4}/.pre-commit-config.yaml +0 -0
  41. {mcp_use-1.3.2 → mcp_use-1.3.4}/CHANGELOG.md +0 -0
  42. {mcp_use-1.3.2 → mcp_use-1.3.4}/CLAUDE.md +0 -0
  43. {mcp_use-1.3.2 → mcp_use-1.3.4}/LICENSE +0 -0
  44. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/README.md +0 -0
  45. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/api-reference/adapters.mdx +0 -0
  46. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/api-reference/introduction.mdx +0 -0
  47. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/api-reference/mcpclient.mdx +0 -0
  48. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/community/showcase.mdx +0 -0
  49. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/development/telemetry.mdx +0 -0
  50. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/development.mdx +0 -0
  51. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/agent-configuration.mdx +0 -0
  52. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/client-configuration.mdx +0 -0
  53. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/configuration.mdx +0 -0
  54. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/essentials/llm-integration.mdx +0 -0
  55. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/favicon.svg +0 -0
  56. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/fonts.css +0 -0
  57. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/guides/building-custom-agents.mdx +0 -0
  58. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/guides/logging.mdx +0 -0
  59. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/guides/multi-server-setup.mdx +0 -0
  60. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/guides/security.mdx +0 -0
  61. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/01.png +0 -0
  62. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/02.png +0 -0
  63. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/configuration-dark.png +0 -0
  64. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/configuration-light.png +0 -0
  65. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/examples-dark.png +0 -0
  66. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/examples-light.png +0 -0
  67. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/hero-dark.png +0 -0
  68. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/hero-light.png +0 -0
  69. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/installation-dark.png +0 -0
  70. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/installation-light.png +0 -0
  71. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/quickstart-dark.png +0 -0
  72. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/images/quickstart-light.png +0 -0
  73. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/index.mdx +0 -0
  74. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/installation.mdx +0 -0
  75. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/logo/dark.svg +0 -0
  76. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/logo/light.svg +0 -0
  77. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/logo/react.svg +0 -0
  78. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/quickstart.mdx +0 -0
  79. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/snippets/snippet-intro.mdx +0 -0
  80. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/snippets/youtube-embed.mdx +0 -0
  81. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/troubleshooting/common-issues.mdx +0 -0
  82. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/troubleshooting/connection-errors.mdx +0 -0
  83. {mcp_use-1.3.2 → mcp_use-1.3.4}/docs/troubleshooting/performance.mdx +0 -0
  84. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/airbnb_mcp.json +0 -0
  85. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/airbnb_use.py +0 -0
  86. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/blender_use.py +0 -0
  87. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/browser_mcp.json +0 -0
  88. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/browser_use.py +0 -0
  89. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/chat_example.py +0 -0
  90. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/filesystem_use.py +0 -0
  91. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/http_example.py +0 -0
  92. {mcp_use-1.3.2 → mcp_use-1.3.4}/examples/sandbox_everything.py +0 -0
  93. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/__init__.py +0 -0
  94. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/adapters/__init__.py +0 -0
  95. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/adapters/langchain_adapter.py +0 -0
  96. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/agents/__init__.py +0 -0
  97. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/agents/base.py +0 -0
  98. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/agents/prompts/system_prompt_builder.py +0 -0
  99. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/agents/prompts/templates.py +0 -0
  100. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/client.py +0 -0
  101. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/config.py +0 -0
  102. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/__init__.py +0 -0
  103. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/http.py +0 -0
  104. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/stdio.py +0 -0
  105. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/utils.py +0 -0
  106. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/connectors/websocket.py +0 -0
  107. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/logging.py +0 -0
  108. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/__init__.py +0 -0
  109. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/server_manager.py +0 -0
  110. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/__init__.py +0 -0
  111. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/base_tool.py +0 -0
  112. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/connect_server.py +0 -0
  113. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/disconnect_server.py +0 -0
  114. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/get_active_server.py +0 -0
  115. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/list_servers_tool.py +0 -0
  116. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/managers/tools/use_tool.py +0 -0
  117. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/observability/__init__.py +0 -0
  118. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/observability/laminar.py +0 -0
  119. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/observability/langfuse.py +0 -0
  120. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/session.py +0 -0
  121. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/__init__.py +0 -0
  122. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/base.py +0 -0
  123. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/sse.py +0 -0
  124. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/stdio.py +0 -0
  125. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/streamable_http.py +0 -0
  126. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/task_managers/websocket.py +0 -0
  127. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/telemetry/__init__.py +0 -0
  128. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/telemetry/events.py +0 -0
  129. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/telemetry/telemetry.py +0 -0
  130. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/telemetry/utils.py +0 -0
  131. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/types/sandbox.py +0 -0
  132. {mcp_use-1.3.2 → mcp_use-1.3.4}/mcp_use/utils.py +0 -0
  133. {mcp_use-1.3.2 → mcp_use-1.3.4}/pytest.ini +0 -0
  134. {mcp_use-1.3.2 → mcp_use-1.3.4}/ruff.toml +0 -0
  135. {mcp_use-1.3.2 → mcp_use-1.3.4}/static/logo_black.svg +0 -0
  136. {mcp_use-1.3.2 → mcp_use-1.3.4}/static/logo_white.svg +0 -0
  137. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/conftest.py +0 -0
  138. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/__init__.py +0 -0
  139. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/servers_for_testing/__init__.py +0 -0
  140. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/servers_for_testing/custom_streaming_server.py +0 -0
  141. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/servers_for_testing/simple_server.py +0 -0
  142. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/servers_for_testing/timeout_test_server.py +0 -0
  143. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/customStreaming/__init__.py +0 -0
  144. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/customStreaming/test_custom_streaming_integration.py +0 -0
  145. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/sse/test_sse_integration.py +0 -0
  146. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/stdio/test_stdio_integration.py +0 -0
  147. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/integration/transports/streamableHttp/test_streamable_http_integration.py +0 -0
  148. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_client.py +0 -0
  149. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_config.py +0 -0
  150. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_http_connector.py +0 -0
  151. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_logging.py +0 -0
  152. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_search_tools_issue_138.py +0 -0
  153. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_session.py +0 -0
  154. {mcp_use-1.3.2 → mcp_use-1.3.4}/tests/unit/test_websocket_connection_manager.py +0 -0
@@ -2,9 +2,8 @@ name: Release
2
2
 
3
3
  on:
4
4
  workflow_run:
5
- workflows: ["Python Tests"]
6
- branches:
7
- - main
5
+ workflows: ["Python Tests", "Transports"]
6
+ branches: [main]
8
7
  types:
9
8
  - completed
10
9
 
@@ -15,9 +14,8 @@ permissions:
15
14
 
16
15
  jobs:
17
16
  check-version-and-publish:
18
- # Only proceed if the referenced workflow completed successfully
19
- if: ${{ github.event.workflow_run.conclusion == 'success' }}
20
17
  runs-on: ubuntu-latest
18
+ if: ${{ github.event.workflow_run.conclusion == 'success' }}
21
19
  steps:
22
20
  - uses: actions/checkout@v3
23
21
  with:
@@ -73,6 +71,7 @@ jobs:
73
71
  draft: false
74
72
  prerelease: false
75
73
  generateReleaseNotes: false
74
+ omitBodyDuringUpdate: true
76
75
 
77
76
  - name: Publish to PyPI
78
77
  if: steps.check-version.outputs.is_new_version == 'true'
@@ -0,0 +1,18 @@
1
+ name: Close Stale Issues
2
+
3
+ on:
4
+ schedule:
5
+ - cron: "0 10 * * *"
6
+
7
+ permissions:
8
+ actions: write
9
+ contents: write # only for delete-branch option
10
+ issues: write
11
+ pull-requests: write
12
+
13
+ jobs:
14
+ close-stale-issues:
15
+ runs-on: ubuntu-latest
16
+ steps:
17
+ - name: Close Stale Issues
18
+ uses: actions/stale@v9.1.0
@@ -60,7 +60,7 @@ representative at an online or offline event.
60
60
 
61
61
  Instances of abusive, harassing, or otherwise unacceptable behavior may be
62
62
  reported to the community leaders responsible for enforcement at
63
- dev@mcp-use.io.
63
+ dev@mcp-use.com.
64
64
  All complaints will be reviewed and investigated promptly and fairly.
65
65
 
66
66
  All community leaders are obligated to respect the privacy and security of the
@@ -39,7 +39,7 @@ MCP-Use requires:
39
39
  ```
40
40
  3. Install the package in development mode:
41
41
  ```bash
42
- pip install -e ".[dev,search]"
42
+ pip install -e ".[dev,search,e2b]"
43
43
  ```
44
44
  4. Set up pre-commit hooks:
45
45
  ```bash
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-use
3
- Version: 1.3.2
3
+ Version: 1.3.4
4
4
  Summary: MCP Library for LLMs
5
5
  Author-email: Pietro Zullo <pietro.zullo@gmail.com>
6
6
  License: MIT
@@ -15,26 +15,20 @@ Classifier: Programming Language :: Python :: 3.12
15
15
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
16
16
  Requires-Python: >=3.11
17
17
  Requires-Dist: aiohttp>=3.9.0
18
- Requires-Dist: anyio>=4.0.0
19
- Requires-Dist: authlib>=1.5.2
20
- Requires-Dist: httpx>=0.28.1
21
18
  Requires-Dist: jsonschema-pydantic>=0.1.0
22
- Requires-Dist: langchain-community>=0.0.10
23
19
  Requires-Dist: langchain>=0.1.0
24
20
  Requires-Dist: mcp>=1.9.3
25
21
  Requires-Dist: posthog>=4.8.0
26
22
  Requires-Dist: pydantic>=2.0.0
27
23
  Requires-Dist: python-dotenv>=1.0.0
28
24
  Requires-Dist: scarf-sdk>=0.1.0
29
- Requires-Dist: starlette>=0.41.0
30
- Requires-Dist: typing-extensions>=4.8.0
31
- Requires-Dist: uvicorn>=0.32.0
32
25
  Requires-Dist: websockets>=12.0
33
26
  Provides-Extra: anthropic
34
27
  Requires-Dist: langchain-anthropic; extra == 'anthropic'
35
28
  Provides-Extra: dev
36
29
  Requires-Dist: black>=23.9.0; extra == 'dev'
37
- Requires-Dist: fastmcp; extra == 'dev'
30
+ Requires-Dist: fastapi; extra == 'dev'
31
+ Requires-Dist: fastmcp==2.8.0; extra == 'dev'
38
32
  Requires-Dist: isort>=5.12.0; extra == 'dev'
39
33
  Requires-Dist: mypy>=1.5.0; extra == 'dev'
40
34
  Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
@@ -49,6 +43,7 @@ Provides-Extra: search
49
43
  Requires-Dist: fastembed>=0.0.1; extra == 'search'
50
44
  Description-Content-Type: text/markdown
51
45
 
46
+ <div align="center">
52
47
  <div align="center" style="margin: 0 auto; max-width: 80%;">
53
48
  <picture>
54
49
  <source media="(prefers-color-scheme: dark)" srcset="static/logo_white.svg">
@@ -57,24 +52,23 @@ Description-Content-Type: text/markdown
57
52
  </picture>
58
53
  </div>
59
54
 
60
- <h1 align="center">Unified MCP Client Library </h1>
55
+ <br>
56
+
57
+ # Connect any LLM to any MCP server
58
+
61
59
  <p align="center">
60
+ <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
61
+ <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
62
62
  <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
63
63
  <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
64
- <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
65
- <img src="https://static.pepy.tech/badge/mcp-use" /></a>
66
- <a href="https://pypi.org/project/mcp_use/" alt="Python Versions">
67
- <img src="https://img.shields.io/pypi/pyversions/mcp_use.svg" /></a>
68
- <a href="https://docs.mcp-use.io" alt="Documentation">
69
- <img src="https://img.shields.io/badge/docs-mcp--use.io-blue" /></a>
70
- <a href="https://mcp-use.io" alt="Website">
71
- <img src="https://img.shields.io/badge/website-mcp--use.io-blue" /></a>
72
64
  <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
73
65
  <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
74
- <a href="https://github.com/astral-sh/ruff" alt="Code style: Ruff">
75
- <img src="https://img.shields.io/badge/code%20style-ruff-000000.svg" /></a>
76
- <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
77
- <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
66
+ <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
67
+ <img src="https://static.pepy.tech/badge/mcp-use" /></a>
68
+ <a href="https://docs.mcp-use.com" alt="Documentation">
69
+ <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
70
+ <a href="https://mcp-use.com" alt="Website">
71
+ <img src="https://img.shields.io/badge/website-mcp--use.com-blue" /></a>
78
72
  </p>
79
73
  <p align="center">
80
74
  <a href="https://x.com/pietrozullo" alt="Twitter Follow - Pietro">
@@ -84,15 +78,19 @@ Description-Content-Type: text/markdown
84
78
  <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
85
79
  <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
86
80
  </p>
87
- 🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom agents that have tool access, without using closed source or application clients.
81
+ </div>
88
82
 
89
- 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! <b>[Try mcp-use chat *(beta)* ](https://chat.mcp-use.io)</b>.
83
+ 🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom MCP agents that have tool access, without using closed source or application clients.
90
84
 
91
85
  💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
92
86
 
87
+ - Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
88
+ - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
89
+
90
+ 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
91
+
93
92
  # Features
94
93
 
95
- ## ✨ Key Features
96
94
  <table>
97
95
  <tr>
98
96
  <th width="400">Feature</th>
@@ -107,8 +105,8 @@ Description-Content-Type: text/markdown
107
105
  <td>Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.)</td>
108
106
  </tr>
109
107
  <tr>
110
- <td>🌐 <a href="https://mcp-use.io/builder"><strong>Code Builder</strong></a></td>
111
- <td>Explore MCP capabilities and generate starter code with the interactive <a href="https://mcp-use.io/builder">code builder</a>.</td>
108
+ <td>🌐 <a href="https://mcp-use.com/builder"><strong>Code Builder</strong></a></td>
109
+ <td>Explore MCP capabilities and generate starter code with the interactive <a href="https://mcp-use.com/builder">code builder</a>.</td>
112
110
  </tr>
113
111
  <tr>
114
112
  <td>🔗 <a href="#http-connection-example"><strong>HTTP Support</strong></a></td>
@@ -131,7 +129,7 @@ Description-Content-Type: text/markdown
131
129
  <td>Build your own agents with any framework using the LangChain adapter or create new adapters</td>
132
130
  </tr>
133
131
  <tr>
134
- <td>❓ <a href="https://mcp-use.io/what-should-we-build-next"><strong>What should we build next</strong></a></td>
132
+ <td>❓ <a href="https://mcp-use.com/what-should-we-build-next"><strong>What should we build next</strong></a></td>
135
133
  <td>Let us know what you'd like us to build next</td>
136
134
  </tr>
137
135
  </table>
@@ -163,6 +161,7 @@ pip install langchain-openai
163
161
  # For Anthropic
164
162
  pip install langchain-anthropic
165
163
  ```
164
+
166
165
  For other providers, check the [LangChain chat models documentation](https://python.langchain.com/docs/integrations/chat/) and add your API keys for the provider you want to use to your `.env` file.
167
166
 
168
167
  ```bash
@@ -718,7 +717,7 @@ async def main():
718
717
 
719
718
  # Create a custom LangChain agent
720
719
  llm_with_tools = llm.bind_tools(tools)
721
- result = await llm_with_tools.ainvoke("What tools do you have avilable ? ")
720
+ result = await llm_with_tools.ainvoke("What tools do you have available ? ")
722
721
  print(result)
723
722
 
724
723
 
@@ -799,7 +798,6 @@ Thanks to all our amazing contributors!
799
798
  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" />
800
799
  </a>
801
800
 
802
-
803
801
  ## Top Starred Dependents
804
802
 
805
803
  <!-- gh-dependents-info-used-by-start -->
@@ -862,6 +860,7 @@ Thanks to all our amazing contributors!
862
860
  # License
863
861
 
864
862
  MIT
863
+
865
864
  # Citation
866
865
 
867
866
  If you use MCP-Use in your research or project, please cite:
@@ -875,3 +874,5 @@ If you use MCP-Use in your research or project, please cite:
875
874
  url = {https://github.com/pietrozullo/mcp-use}
876
875
  }
877
876
  ```
877
+
878
+ <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=732589b6-6850-4b8c-aa25-906c0979e426&page=README.md" />
@@ -1,3 +1,4 @@
1
+ <div align="center">
1
2
  <div align="center" style="margin: 0 auto; max-width: 80%;">
2
3
  <picture>
3
4
  <source media="(prefers-color-scheme: dark)" srcset="static/logo_white.svg">
@@ -6,24 +7,23 @@
6
7
  </picture>
7
8
  </div>
8
9
 
9
- <h1 align="center">Unified MCP Client Library </h1>
10
+ <br>
11
+
12
+ # Connect any LLM to any MCP server
13
+
10
14
  <p align="center">
15
+ <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
16
+ <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
11
17
  <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
12
18
  <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
13
- <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
14
- <img src="https://static.pepy.tech/badge/mcp-use" /></a>
15
- <a href="https://pypi.org/project/mcp_use/" alt="Python Versions">
16
- <img src="https://img.shields.io/pypi/pyversions/mcp_use.svg" /></a>
17
- <a href="https://docs.mcp-use.io" alt="Documentation">
18
- <img src="https://img.shields.io/badge/docs-mcp--use.io-blue" /></a>
19
- <a href="https://mcp-use.io" alt="Website">
20
- <img src="https://img.shields.io/badge/website-mcp--use.io-blue" /></a>
21
19
  <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
22
20
  <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
23
- <a href="https://github.com/astral-sh/ruff" alt="Code style: Ruff">
24
- <img src="https://img.shields.io/badge/code%20style-ruff-000000.svg" /></a>
25
- <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
26
- <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
21
+ <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
22
+ <img src="https://static.pepy.tech/badge/mcp-use" /></a>
23
+ <a href="https://docs.mcp-use.com" alt="Documentation">
24
+ <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
25
+ <a href="https://mcp-use.com" alt="Website">
26
+ <img src="https://img.shields.io/badge/website-mcp--use.com-blue" /></a>
27
27
  </p>
28
28
  <p align="center">
29
29
  <a href="https://x.com/pietrozullo" alt="Twitter Follow - Pietro">
@@ -33,15 +33,19 @@
33
33
  <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
34
34
  <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
35
35
  </p>
36
- 🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom agents that have tool access, without using closed source or application clients.
36
+ </div>
37
37
 
38
- 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! <b>[Try mcp-use chat *(beta)* ](https://chat.mcp-use.io)</b>.
38
+ 🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom MCP agents that have tool access, without using closed source or application clients.
39
39
 
40
40
  💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
41
41
 
42
+ - Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
43
+ - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
44
+
45
+ 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
46
+
42
47
  # Features
43
48
 
44
- ## ✨ Key Features
45
49
  <table>
46
50
  <tr>
47
51
  <th width="400">Feature</th>
@@ -56,8 +60,8 @@
56
60
  <td>Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.)</td>
57
61
  </tr>
58
62
  <tr>
59
- <td>🌐 <a href="https://mcp-use.io/builder"><strong>Code Builder</strong></a></td>
60
- <td>Explore MCP capabilities and generate starter code with the interactive <a href="https://mcp-use.io/builder">code builder</a>.</td>
63
+ <td>🌐 <a href="https://mcp-use.com/builder"><strong>Code Builder</strong></a></td>
64
+ <td>Explore MCP capabilities and generate starter code with the interactive <a href="https://mcp-use.com/builder">code builder</a>.</td>
61
65
  </tr>
62
66
  <tr>
63
67
  <td>🔗 <a href="#http-connection-example"><strong>HTTP Support</strong></a></td>
@@ -80,7 +84,7 @@
80
84
  <td>Build your own agents with any framework using the LangChain adapter or create new adapters</td>
81
85
  </tr>
82
86
  <tr>
83
- <td>❓ <a href="https://mcp-use.io/what-should-we-build-next"><strong>What should we build next</strong></a></td>
87
+ <td>❓ <a href="https://mcp-use.com/what-should-we-build-next"><strong>What should we build next</strong></a></td>
84
88
  <td>Let us know what you'd like us to build next</td>
85
89
  </tr>
86
90
  </table>
@@ -112,6 +116,7 @@ pip install langchain-openai
112
116
  # For Anthropic
113
117
  pip install langchain-anthropic
114
118
  ```
119
+
115
120
  For other providers, check the [LangChain chat models documentation](https://python.langchain.com/docs/integrations/chat/) and add your API keys for the provider you want to use to your `.env` file.
116
121
 
117
122
  ```bash
@@ -667,7 +672,7 @@ async def main():
667
672
 
668
673
  # Create a custom LangChain agent
669
674
  llm_with_tools = llm.bind_tools(tools)
670
- result = await llm_with_tools.ainvoke("What tools do you have avilable ? ")
675
+ result = await llm_with_tools.ainvoke("What tools do you have available ? ")
671
676
  print(result)
672
677
 
673
678
 
@@ -748,7 +753,6 @@ Thanks to all our amazing contributors!
748
753
  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" />
749
754
  </a>
750
755
 
751
-
752
756
  ## Top Starred Dependents
753
757
 
754
758
  <!-- gh-dependents-info-used-by-start -->
@@ -811,6 +815,7 @@ Thanks to all our amazing contributors!
811
815
  # License
812
816
 
813
817
  MIT
818
+
814
819
  # Citation
815
820
 
816
821
  If you use MCP-Use in your research or project, please cite:
@@ -824,3 +829,5 @@ If you use MCP-Use in your research or project, please cite:
824
829
  url = {https://github.com/pietrozullo/mcp-use}
825
830
  }
826
831
  ```
832
+
833
+ <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=732589b6-6850-4b8c-aa25-906c0979e426&page=README.md" />
@@ -0,0 +1,141 @@
1
+ ---
2
+ title: MCPAgent
3
+ description: "MCPAgent API Documentation"
4
+ icon: "bot"
5
+ ---
6
+
7
+ # MCPAgent API Reference
8
+
9
+ ## stream
10
+
11
+ ```python
12
+ async def stream(
13
+ query: str,
14
+ max_steps: int | None = None,
15
+ manage_connector: bool = True,
16
+ external_history: list[BaseMessage] | None = None,
17
+ ) -> AsyncGenerator[tuple[AgentAction, str] | str, None]:
18
+ ```
19
+
20
+ Stream agent execution step-by-step. Yields intermediate steps as `(AgentAction, str)` tuples, followed by the final result as a string.
21
+
22
+ **Parameters:**
23
+ - `query` (str): The query to execute
24
+ - `max_steps` (int, optional): Maximum number of steps to take
25
+ - `manage_connector` (bool): Whether to handle connector lifecycle
26
+ - `external_history` (list[BaseMessage], optional): External conversation history
27
+
28
+ **Yields:**
29
+ - `(AgentAction, str)`: Intermediate steps containing the action and observation
30
+ - `str`: Final result string
31
+
32
+ **Example:**
33
+
34
+ ```python
35
+ async for item in agent.stream("What's the weather like?"):
36
+ if isinstance(item, str):
37
+ print(f"Final result: {item}")
38
+ else:
39
+ action, observation = item
40
+ print(f"Tool: {action.tool}, Result: {observation}")
41
+ ```
42
+
43
+ ## run
44
+
45
+ ```python
46
+ async def run(
47
+ query: str,
48
+ max_steps: int | None = None,
49
+ manage_connector: bool = True,
50
+ external_history: list[BaseMessage] | None = None,
51
+ ) -> str:
52
+ ```
53
+
54
+ Run agent execution and return the final result. Uses the streaming implementation internally.
55
+
56
+ **Parameters:**
57
+ - `query` (str): The query to execute
58
+ - `max_steps` (int, optional): Maximum number of steps to take
59
+ - `manage_connector` (bool): Whether to handle connector lifecycle
60
+ - `external_history` (list[BaseMessage], optional): External conversation history
61
+
62
+ **Returns:**
63
+ - `str`: The final result
64
+
65
+ **Example:**
66
+
67
+ ```python
68
+ result = await agent.run("What's the weather like?")
69
+ print(result)
70
+ ```
71
+
72
+ ## astream
73
+
74
+ ```python
75
+ async def astream(
76
+ query: str,
77
+ max_steps: int | None = None,
78
+ manage_connector: bool = True,
79
+ external_history: list[BaseMessage] | None = None,
80
+ ) -> AsyncIterator[str]:
81
+ ```
82
+
83
+ Asynchronous streaming interface for low-level agent events. Yields incremental results, tool actions, and intermediate steps as they are generated by the agent.
84
+
85
+ **Parameters:**
86
+ - `query` (str): The query to execute
87
+ - `max_steps` (int, optional): Maximum number of steps to take
88
+ - `manage_connector` (bool): Whether to handle connector lifecycle
89
+ - `external_history` (list[BaseMessage], optional): External conversation history
90
+
91
+ **Yields:**
92
+ - `str`: Streaming chunks of the agent's output
93
+
94
+ **Example:**
95
+
96
+ ```python
97
+ async for chunk in agent.astream("hello"):
98
+ print(chunk, end="", flush=True)
99
+ ```
100
+
101
+ ## Method Comparison
102
+
103
+ | Method | Use Case | Output Type | Granularity |
104
+ |--------|----------|-------------|-------------|
105
+ | `stream()` | Step-by-step workflow tracking | Steps + final result | Tool-level |
106
+ | `run()` | Simple execution | Final result only | Complete |
107
+ | `astream()` | Real-time chat interfaces | Streaming chunks | Token-level |
108
+
109
+ ## Configuration Methods
110
+
111
+ ### get_conversation_history
112
+
113
+ ```python
114
+ def get_conversation_history() -> list[BaseMessage]:
115
+ ```
116
+
117
+ Get the current conversation history.
118
+
119
+ ### clear_conversation_history
120
+
121
+ ```python
122
+ def clear_conversation_history() -> None:
123
+ ```
124
+
125
+ Clear the conversation history.
126
+
127
+ ### set_system_message
128
+
129
+ ```python
130
+ def set_system_message(message: str) -> None:
131
+ ```
132
+
133
+ Set a new system message for the agent.
134
+
135
+ ### close
136
+
137
+ ```python
138
+ async def close() -> None:
139
+ ```
140
+
141
+ Close the MCP connection and clean up resources.
@@ -4,6 +4,23 @@ description: "New updates and improvements"
4
4
  mode: "center"
5
5
  ---
6
6
 
7
+ <Update label="2025‑06‑19">
8
+ ## v1.3.3
9
+ - Set default logging level to info
10
+ - Fix: prevent double async cleanup and event loop errors in astream
11
+ - Fix: Raise import error for fastembed, server manager does not silently fail
12
+ - Fix: search tools tuple unpacking error
13
+ </Update>
14
+
15
+ <Update label="2025‑06‑10">
16
+ ## v1.3.1
17
+ - Remove client options for easier usage
18
+ - Add streamable HTTP support
19
+ - Fix websocket error positional arguments (headers were missing)
20
+ - Fix connection state tracking after SSE disconnection
21
+ - Add CLAUDE.md for development guidance
22
+ </Update>
23
+
7
24
  <Update label="2025‑05‑27">
8
25
  ## v1.3.0
9
26
  - Added optional E2B sandbox execution so MCP servers can run in secure cloud sandboxes.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: "Observability"
3
- description: "Trace and monitor your MCP agents with Langfuse and Laminar"
3
+ description: "Trace and monitor your MCP agents with Langfuse, Laminar, and LangSmith"
4
4
  icon: "eye"
5
5
  ---
6
6
 
@@ -24,6 +24,7 @@ MCP-use integrates with two leading observability platforms:
24
24
 
25
25
  - **[Langfuse](https://langfuse.com)** - Open-source LLM observability with self-hosting options
26
26
  - **[Laminar](https://www.lmnr.ai)** - Comprehensive AI application monitoring platform
27
+ - **[LangSmith](https://smith.langchain.com/)** - LangChain's observability platform
27
28
 
28
29
  Choose the platform that best fits your needs. Each platform automatically initializes when you import mcp_use if their environment variables are set.
29
30
 
@@ -38,7 +38,8 @@
38
38
  "pages": [
39
39
  "essentials/agent-configuration",
40
40
  "essentials/server-manager",
41
- "essentials/llm-integration"
41
+ "essentials/llm-integration",
42
+ "guides/streaming"
42
43
  ]
43
44
  },
44
45
  {
@@ -47,7 +48,6 @@
47
48
  "guides/building-custom-agents",
48
49
  "guides/logging",
49
50
  "guides/multi-server-setup",
50
- "guides/streaming",
51
51
  "guides/security"
52
52
  ]
53
53
  },
@@ -55,7 +55,8 @@
55
55
  "group": "Development",
56
56
  "pages": [
57
57
  "development",
58
- "development/telemetry"
58
+ "development/telemetry",
59
+ "development/observability"
59
60
  ]
60
61
  },
61
62
  {
@@ -143,11 +144,11 @@
143
144
  "items": [
144
145
  {
145
146
  "label": "Website",
146
- "href": "https://mcp-use.io"
147
+ "href": "https://mcp-use.com"
147
148
  },
148
149
  {
149
150
  "label": "Cloud Chat",
150
- "href": "https://chat.mcp-use.io"
151
+ "href": "https://chat.mcp-use.com"
151
152
  },
152
153
  {
153
154
  "label": "GitHub",
@@ -221,7 +222,7 @@
221
222
  "referrer": "origin",
222
223
  "language": "en",
223
224
  "copyright": "Copyright 2025 mcp-use",
224
- "reply-to": "dev@mcp-use.io",
225
+ "reply-to": "dev@mcp-use.com",
225
226
  "distribution": "global",
226
227
  "coverage": "Worldwide",
227
228
  "category": "Technology",
@@ -237,7 +238,7 @@
237
238
  "msapplication-config": "/browserconfig.xml",
238
239
  "og:title": "mcp-use - Connect Any LLM to Any MCP Server",
239
240
  "og:type": "website",
240
- "og:url": "https://mcp-use.io",
241
+ "og:url": "https://mcp-use.com",
241
242
  "og:image": "https://repository-images.githubusercontent.com/956472076/d2b369ee-1bf9-466c-9ecc-e96c2f95b81a",
242
243
  "og:description": "Open source library enabling developers to connect any LLM to any MCP server. Build custom AI agents with tool access without vendor lock-in.",
243
244
  "og:site_name": "mcp-use",
@@ -143,8 +143,8 @@ client = MCPClient.from_config_file(
143
143
 
144
144
  For example:
145
145
 
146
- - If your configuration includes `command` and `args` and sandbox parmater is False` (default), a local STDIO connection will be used
147
- - If your configuration includes `command` and `args` and sandbox parmater is True`, a sandboxed execution connection will be used
146
+ - If your configuration includes `command` and `args` and sandbox parameter is False` (default), a local STDIO connection will be used
147
+ - If your configuration includes `command` and `args` and sandbox parameter is True`, a sandboxed execution connection will be used
148
148
  - If your configuration has a `url` starting with `http://` or `https://`, an HTTP connection will be used
149
149
 
150
150
  This automatic inference simplifies the configuration process and ensures the appropriate connection type is used without requiring explicit specification.
@@ -1,3 +1,4 @@
1
+
1
2
  ---
2
3
  title: 'Server Manager'
3
4
  description: 'Intelligent management of multiple MCP servers and tool discovery'