Mcpadapt

What is mcpadapt

mcpadapt is a versatile tool developed by the company grll that allows users to seamlessly integrate with over 650 Model Context Protocol (MCP) servers. These servers provide a vast array of tools and data to enhance your agentic workflows. MCP is an open-source protocol developed by Anthropic, enabling AI systems to connect securely with various data sources and tools. By using mcpadapt, you can access and utilize these resources effortlessly within supported agentic frameworks, such as Smolagents and Langchain. This integration opens up a world of possibilities for AI-driven applications by providing context, tools, and prompts that are essential for real-time information access.

How to Use mcpadapt

To start using mcpadapt, you must first install it within your chosen agentic framework. Here's a quick guide on how to integrate mcpadapt:

Installation

For Smolagents:
Smolagents version 1.4.1 and later comes with mcpadapt pre-integrated. You can add it to your environment using:
```
uv add smolagents[mcp]
```
For Other Frameworks:
If you're using frameworks like Langchain, you can install mcpadapt with specific dependencies suited to your framework:
```
# using uv
uv add mcpadapt[langchain]

# or using pip
pip install mcpadapt[langchain]
```

Usage

With Smolagents:
mcpadapt works seamlessly with Smolagents, allowing you to access tools through a simple tool collection:

from mcp import StdioServerParameters
from smolagents.tools import ToolCollection

serverparams = StdioServerParameters(command="uv", args=["run", "src/echo.py"])

with ToolCollection.from_mcp(serverparams) as tool_collection:
    ... # enjoy your tools!

With Other Frameworks:
You can adapt MCP servers into usable tools within your workflow:

from mcp import StdioServerParameters
from mcpadapt.core import MCPAdapt
from mcpadapt.smolagents_adapter import SmolAgentsAdapter

with MCPAdapt(
    StdioServerParameters(command="uv", args=["run", "src/echo.py"]),
    SmolAgentsAdapter(),
) as tools:
    ... # access your tools

Key Features of mcpadapt

Extensive Integration:
Access over 650 MCP servers, providing a rich selection of tools and data to enhance AI workflows.
Framework Compatibility:
Supports integration with popular frameworks like Smolagents and Langchain, with future plans to support more frameworks like Pydantic-AI and Llamaindex.
Ease of Use:
With straightforward installation and usage processes, mcpadapt makes it easy for users to incorporate a wide range of MCP tools without extensive setup.
Adaptability:
Offers a flexible architecture that allows users to create custom adapters for their preferred frameworks, encouraging community contribution and expansion.
Secure and Open-Source:
Built on the open-source Model Context Protocol, ensuring secure, standardized access to external data and tools.

By leveraging mcpadapt, users can enhance their AI systems' capabilities with minimal effort, accessing a plethora of resources and improving their agentic workflows significantly.

PyPI version Python versions Tests License PyPI downloads GitHub Repo stars Unlock 650+ MCP servers tools in your favorite agentic framework. Model Context Protocol is an open-source protocol introduced by Anthropic which allows anyone to simply and quickly make tools and resources available as "MCP Servers". Since its release more than 650 MCP servers have been created giving access to many data & tools to supported "MCP Client". This project makes calling any MCP servers tools seemless from any agentic framework. Virtually providing your agentic worfklow access to 650+ MCP servers tools. Look at glama.ai or .ai to give you an idea of what your agent could access.

Installation Instructions

Smolagents

Smolagents 1.4.1 and above directly ships with mcpadapt integrated in their tool collections object. It means you can directly use it from smolagents:

uv add smolagents[mcp]

Other Frameworks

Each agent framework has its own set of optional dependencies to not clutter with useless dependencies. You choose the flavor you want by adding your framework in brackets in the installation command.

# with uv
uv add mcpadapt[langchain]
# or with pip
pip install mcpadapt[langchain]

Framework supported at the moment: smolagents, langchain. You can also add multiple framework comma separated if needed.

Usage

Smolagents

Since mcpadapt is part of smolagents simple use tool collection from smolagents like:

from mcp import StdioServerParameters
from smolagents.tools import ToolCollection
serverparams = StdioServerParameters(command="uv", args=["run", "src/echo.py"])
with ToolCollection.from_mcp(serverparams) as tool_collection:
 ... # enjoy your tools!

Other Frameworks

MCPAdapt adapt any MCP servers into tools that you can use right in your agentic workflow:

from mcp import StdioServerParameters
from mcpadapt.core import MCPAdapt
from mcpadapt.smolagents_adapter import SmolAgentsAdapter
with MCPAdapt(
 # specify the command to run your favorite MCP server (support also and co.)
 StdioServerParameters(command="uv", args=["run", "src/echo.py"]),
 # or a dict of sse server parameters e.g. {"url": "headers": ...}
 # specify the adapter you want to use to adapt MCP into your tool in this case smolagents.
 SmolAgentsAdapter(),
) as tools:
 # enjoy your smolagents tools as if you wrote them yourself

MCP Adapt supports Smolagents, Langchain, [pydantic.dev, Llammaindex and more...]*. *coming soon. See our examples for more details on how to use.

Contribute

If your favorite agentic framework is missing no problem add it yourself it's quite easy:

create a new module in src/mcpadapt/{name_of_your_framework}_adapter.py:

class YourFrameworkAdapter(ToolAdapter):
 def adapt(
 self,
 func: Callable[[dict | None], mcp.types.CallToolResult],
 mcp_tool: mcp.types.Tool,
 ) -> YourFramework.Tool:
 # HERE implement how the adapter should convert a simple function and mcp_tool (JSON Schema)
 # into your framework tool. see smolagents_adapter.py for an example
 def async_adapt(
 self,
 afunc: Callable[[dict | None], Coroutine[Any, Any, mcp.types.CallToolResult]],
 mcp_tool: mcp.types.Tool,
 ) -> YourFramework.Tool:
 # if your framework supports async function even better use async_adapt.

and that's it, test that your adapter is working and send us a PR to share it with the world.

Roadmap

How to Use

To use the mcpadapt, follow these steps:

Visit https://github.com/grll/mcpadapt
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using mcpadapt capabilities within your Claude conversations

Additional Information

Created

January 11, 2025

Company

grll

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More

Mcpadapt

What is mcpadapt

How to Use mcpadapt

Installation

Usage

Key Features of mcpadapt

Installation Instructions

Smolagents

Other Frameworks

Usage

Smolagents

Other Frameworks

Contribute

Roadmap

How to Use

Additional Information

Created

Company

Related MCP Servers

MCP Git Ingest

MCP Server Clickup

Prometheus MCP Server

Start building your own MCP Server