Python SDK for interacting with the Toolbox service with LlamaIndex
Project description
MCP Toolbox LlamaIndex SDK
This SDK allows you to seamlessly integrate the functionalities of MCP Toolbox into your LlamaIndex LLM applications, enabling advanced orchestration and interaction with GenAI models.
For detailed guides, authentication examples, and advanced configuration, visit the Python SDK LlamaIndex Guide.
Table of Contents
Installation
pip install toolbox-llamaindex
Quickstart
Here's a minimal example to get you started using LlamaIndex:
import asyncio
from llama_index.llms.google_genai import GoogleGenAI
from llama_index.core.agent.workflow import AgentWorkflow
from toolbox_llamaindex import ToolboxClient
async def run_agent():
async with ToolboxClient("http://127.0.0.1:5000") as toolbox:
tools = toolbox.load_toolset()
vertex_model = GoogleGenAI(
model="gemini-3-flash-preview",
vertexai_config={"project": "project-id", "location": "us-central1"},
)
agent = AgentWorkflow.from_tools_or_functions(
tools,
llm=vertex_model,
system_prompt="You are a helpful assistant.",
)
response = await agent.run(user_msg="Get some response from the agent.")
print(response)
asyncio.run(run_agent())
Usage
The toolbox-llamaindex package provides a dedicated integration to seamlessly load and use MCP Toolbox tools within the LlamaIndex orchestration framework. For detailed guides and advanced configuration, please visit the following sections on our Documentation Site:
- Transport Protocols
- Loading Tools
- Use with LlamaIndex
- Manual Usage
- Client to Server Authentication
- Authenticating Tools
- Binding Parameter Values
- Asynchronous Usage
- OpenTelemetry
Contributing
Contributions are welcome! Please refer to the DEVELOPER.md file for guidelines on how to set up a development environment and run tests.
License
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
Support
If you encounter issues or have questions, check the existing GitHub Issues for the main Toolbox project.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file toolbox_llamaindex-0.8.0.tar.gz.
File metadata
- Download URL: toolbox_llamaindex-0.8.0.tar.gz
- Upload date:
- Size: 19.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b7f213d4347c6eef0983b1725b0bc89a967375fa5191f9ff9ce3666227dbe69
|
|
| MD5 |
c63522ed4fd6a86b974197250cb158bb
|
|
| BLAKE2b-256 |
918e3f477f610b5be9ec8e45bdd15458128d9bfbedb2cdf959316d2858feeb29
|
Provenance
The following attestation bundles were made for toolbox_llamaindex-0.8.0.tar.gz:
Publisher:
google-cloud-sdk-py@oss-exit-gate-prod.iam.gserviceaccount.com
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
toolbox_llamaindex-0.8.0.tar.gz -
Subject digest:
9b7f213d4347c6eef0983b1725b0bc89a967375fa5191f9ff9ce3666227dbe69 - Sigstore transparency entry: 2280157373
- Sigstore integration time:
-
Token Issuer:
https://accounts.google.com -
Service Account:
google-cloud-sdk-py@oss-exit-gate-prod.iam.gserviceaccount.com
-
Statement type:
File details
Details for the file toolbox_llamaindex-0.8.0-py3-none-any.whl.
File metadata
- Download URL: toolbox_llamaindex-0.8.0-py3-none-any.whl
- Upload date:
- Size: 12.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c97e151387cc12965d1bffac50ac2ff103b6e3c9983cdb3a602b8a42d870e00
|
|
| MD5 |
ef3b06a3be6402de0f0b8fbf8bbd8a9b
|
|
| BLAKE2b-256 |
37f2f9bc77597b0e6ca242903cc5d35552f67dfc125d0044b8c491886a2d4d54
|
Provenance
The following attestation bundles were made for toolbox_llamaindex-0.8.0-py3-none-any.whl:
Publisher:
google-cloud-sdk-py@oss-exit-gate-prod.iam.gserviceaccount.com
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
toolbox_llamaindex-0.8.0-py3-none-any.whl -
Subject digest:
3c97e151387cc12965d1bffac50ac2ff103b6e3c9983cdb3a602b8a42d870e00 - Sigstore transparency entry: 2280157355
- Sigstore integration time:
-
Token Issuer:
https://accounts.google.com -
Service Account:
google-cloud-sdk-py@oss-exit-gate-prod.iam.gserviceaccount.com
-
Statement type:
