MCPAdapt
Unlock 650+ MCP servers tools in your favorite agentic framework.
What is MCPAdapt?
MCPAdapt is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unlock 650+ mcp servers tools in your favorite agentic framework.
Unlock 650+ MCP servers tools in your favorite agentic framework.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Unlock 650+ MCP servers tools in your favorite agentic frame
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcpadaptConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCPAdapt
MCPAdapt is a Python library that bridges the Model Context Protocol ecosystem with popular agentic frameworks, letting you use any of 650+ MCP servers as native tools inside LangChain, CrewAI, Google GenAI, and Smolagents workflows. Instead of reimplementing tool wrappers for each framework, MCPAdapt provides a unified adapter layer that converts MCP tool definitions on the fly. This makes it practical to combine data-access MCP servers (files, databases, APIs) with the orchestration logic of your chosen agent framework without extra glue code.
Prerequisites
- Python 3.10 or higher installed
- uv or pip package manager available
- An MCP server to connect to (any of the 650+ compatible servers)
- The target agentic framework installed (LangChain, Smolagents, CrewAI, or Google GenAI)
- An MCP-compatible client such as Claude Desktop if using interactively
Install MCPAdapt with your framework extras
Install the package using uv or pip, specifying the extras for your chosen agentic framework. Multiple frameworks can be included by comma-separating them.
uv add mcpadapt[langchain]
# or for multiple frameworks:
uv add mcpadapt[langchain,smolagents]
# or with pip:
pip install mcpadapt[langchain]Configure the MCP server connection parameters
Use StdioServerParameters from the mcp package to define how MCPAdapt should launch or connect to your MCP server. This specifies the command, arguments, and any environment variables the server needs.
from mcp import StdioServerParameters
server_params = StdioServerParameters(
command="uvx",
args=["mcp-server-fetch"],
env=None # pass server-specific env vars here
)Wrap the MCP server with the framework adapter
Instantiate MCPAdapt with your server parameters and the adapter for your framework. The context manager handles server lifecycle, tool discovery, and schema conversion automatically.
from mcpadapt.core import MCPAdapt
from mcpadapt.langchain_adapter import LangChainAdapter
with MCPAdapt(server_params, LangChainAdapter()) as tools:
# tools is a list of LangChain-compatible BaseTool objects
print([t.name for t in tools])Use the converted tools in your agent
Pass the converted tools directly to your framework's agent or tool executor. The tools behave identically to natively defined framework tools, including argument validation and async support.
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_anthropic import ChatAnthropic
llm = ChatAnthropic(model="claude-3-5-sonnet-latest")
agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools)
result = executor.invoke({"input": "Fetch the homepage of example.com"})Connect multiple MCP servers simultaneously
Pass a list of server parameter dicts instead of a single StdioServerParameters to aggregate tools from multiple MCP servers into one tool collection for your agent.
with MCPAdapt(
[
{"serverparams": StdioServerParameters(command="uvx", args=["mcp-server-fetch"])},
{"serverparams": StdioServerParameters(command="uvx", args=["mcp-server-filesystem", "/tmp"])}
],
LangChainAdapter()
) as tools:
print(f"Total tools available: {len(tools)}")MCPAdapt Examples
Smolagents integration
Use MCPAdapt with Smolagents to load tools from a stdio MCP server into a HfApiModel-powered agent.
{
"mcpServers": {
"mcpadapt-bridge": {
"command": "python",
"args": ["-m", "mcpadapt"],
"env": {}
}
}
}Prompts to try
Once your agent is set up with MCPAdapt-converted tools, try these prompts to exercise the connected MCP server capabilities.
- "List all available tools you have access to and describe what each one does"
- "Use the filesystem tools to list files in /tmp and summarize their sizes"
- "Fetch the content of https://example.com and extract the main heading"
- "Search for recent news about MCP protocol and summarize the top results"Troubleshooting MCPAdapt
ImportError when importing a framework adapter (e.g., mcpadapt.langchain_adapter)
Ensure you installed the correct extras: `pip install mcpadapt[langchain]`. Each framework adapter requires its extras to be installed explicitly. Check `pip show mcpadapt` to confirm the extras are present.
MCP server fails to start or tools list is empty
Verify the command in StdioServerParameters is correct and the MCP server package is installed (e.g., `uvx mcp-server-fetch` should work standalone). Check that any required env vars for the server are passed via the `env` parameter in StdioServerParameters.
Tool schema conversion errors with certain MCP servers
Some MCP servers use advanced JSON Schema features that may not map cleanly to all framework tool formats. Try wrapping the MCPAdapt call in a try/except and inspect the raw tool schemas by setting the adapter to None temporarily to see the raw MCP tool definitions.
Frequently Asked Questions about MCPAdapt
What is MCPAdapt?
MCPAdapt is a Model Context Protocol (MCP) server that unlock 650+ mcp servers tools in your favorite agentic framework. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCPAdapt?
Follow the installation instructions on the MCPAdapt GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCPAdapt?
MCPAdapt works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCPAdapt free to use?
Yes, MCPAdapt is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCPAdapt Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCPAdapt? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCPAdapt in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCPAdapt?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.