MCP Agent Tool Adapter
Transforms MCP tools into collaborative, reasoning agents using modern agent frameworks.
What is MCP Agent Tool Adapter?
MCP Agent Tool Adapter is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to transforms mcp tools into collaborative, reasoning agents using modern agent frameworks.
Transforms MCP tools into collaborative, reasoning agents using modern agent frameworks.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Transforms MCP tools into collaborative, reasoning agents us
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-agent-tool-adapterConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Agent Tool Adapter
The MCP Agent Tool Adapter is a Python framework that wraps standard MCP tool servers and re-exposes them as autonomous reasoning agents. It supports two agent backends — Google ADK (with a FastAPI or CLI interface) and LangGraph (using the ReAct pattern with streaming) — so you can compose multiple MCP tool servers into a single collaborative agent pipeline.
Prerequisites
- Python 3.10 or later with pip installed
- Git to clone the repository
- At least one running MCP tool server to connect (e.g., filesystem server via npx)
- Optional: Google ADK credentials if using the ADK backend
- Optional: OpenAI or compatible LLM API key for the LangGraph ReAct agent
Clone the repository
Clone the mcp-agent-tool-adapter repository to your local machine.
git clone https://github.com/serkanyasr/mcp-agent-tool-adapter.git
cd mcp-agent-tool-adapterInstall Python dependencies
Install all required packages from the requirements file.
pip install -r requirements.txtConfigure mcp_config.json
Create or edit mcp_config.json in the project root to list the MCP tool servers you want to include. Each entry specifies the command and arguments to launch that server.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}Run with the Google ADK backend
Launch the adapter using the Google ADK client. This starts a FastAPI server or CLI interface that exposes the combined agent.
python app_client_adk.pyRun with the LangGraph ReAct backend
Alternatively, launch the LangGraph agent for streaming ReAct-style reasoning across your configured MCP tools.
python app_client_langgraph.pyMCP Agent Tool Adapter Examples
Client configuration
Example mcp_config.json wiring up a filesystem MCP server as a tool source for the adapter.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["@modelcontextprotocol/server-filesystem", "/home/user/data"]
},
"brave-search": {
"command": "npx",
"args": ["@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your-api-key"
}
}
}
}Prompts to try
Interact with the running agent over its ADK or LangGraph interface.
- "Search the web for the latest LangGraph release notes and save a summary to /tmp/notes.txt."
- "List files in the data directory and analyze the contents of the largest CSV."
- "Use all available tools to research a topic and write a structured report."
- "Coordinate a multi-step task: first search for information, then store results locally."Troubleshooting MCP Agent Tool Adapter
ModuleNotFoundError when starting app_client_adk.py or app_client_langgraph.py
Ensure you ran `pip install -r requirements.txt` inside the correct virtual environment. Activate your venv first: `source venv/bin/activate` then reinstall.
MCP tool server fails to launch from mcp_config.json
Verify the command and args in mcp_config.json are correct and the referenced binary (e.g., npx) is on your PATH. Test the server launch command manually in a terminal first.
LangGraph agent hangs or produces no output
Check that your LLM API key environment variable is set correctly. The ReAct agent requires an LLM endpoint. Export OPENAI_API_KEY or the relevant key before starting.
Frequently Asked Questions about MCP Agent Tool Adapter
What is MCP Agent Tool Adapter?
MCP Agent Tool Adapter is a Model Context Protocol (MCP) server that transforms mcp tools into collaborative, reasoning agents using modern agent frameworks. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Agent Tool Adapter?
Follow the installation instructions on the MCP Agent Tool Adapter GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Agent Tool Adapter?
MCP Agent Tool Adapter works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Agent Tool Adapter free to use?
Yes, MCP Agent Tool Adapter is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Agent Tool Adapter Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Agent Tool Adapter? 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 MCP Agent Tool Adapter 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 MCP Agent Tool Adapter?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.