MCPAdapt

What is MCPAdapt?

MCPAdapt is a Python library that seamlessly adapts tools from any MCP (Model Context Protocol) server into any supported agentic framework. It provides access to 650+ existing MCP server tools for frameworks like Smolagents, LangChain, CrewAI, and Google GenAI.

How to use MCPAdapt?

Install MCPAdapt with your framework's optional dependencies, e.g., pip install mcpadapt[langchain]. Then use the MCPAdapt context manager with a StdioServerParameters (or a list of them) and an adapter (e.g., SmolAgentsAdapter()) to get tools usable in your workflow. Also supports SSE‑based remote MCP servers.

Key features of MCPAdapt

• Adapts any MCP server tools into your agentic framework
• Supports Smolagents, LangChain, CrewAI, and Google GenAI
• Works with both local stdio and remote SSE MCP servers
• Allows multiple MCP servers in a single adapter
• Supports async operation where the framework supports it

Use cases of MCPAdapt

• Give a LangChain agent access to hundreds of MCP‑based tools
• Use Smolagents’ ToolCollection to run MCP server tools natively
• Combine multiple MCP servers (e.g., database, file, API) in one CrewAI workflow
• Connect to a remote MCP server over SSE from a Jupyter notebook

FAQ from MCPAdapt

Which agentic frameworks does MCPAdapt support?

Currently supports Smolagents, LangChain, CrewAI, and Google GenAI. Support for Pydantic AI, LlamaIndex, and Swarm is planned.

How do I install MCPAdapt?

Use pip install mcpadapt[your_framework] or uv add mcpadapt[your_framework] (e.g., mcpadapt[langchain]). Multiple frameworks can be comma‑separated.

Is it safe to use MCP servers with MCPAdapt?

Yes, but the README warns to connect only to trusted, verified MCP servers, especially when using SSE transport. Always verify the source and security before connecting.

Can I use multiple MCP servers at the same time?

Yes. Pass a list of StdioServerParameters objects to MCPAdapt. The resulting tools will be flattened into a single list.

Does MCPAdapt support async tools?

Yes, if the underlying agentic framework supports async operations, MCPAdapt can use async_adapt to provide async tools.