Cover image
Try Now
2025-04-15

Transforms MCP tools into collaborative, reasoning agents using modern agent frameworks.

3 years

Works with Finder

1

Github Watches

0

Github Forks

0

Github Stars

mcp-agent-tool-adapter

From Protocol to Intelligence: Powering Agents with MCP.

license last-commit repo-top-language repo-language-count


📍 Overview

MCP Agent Tool Adapter enables modular tool invocation via the MCP protocol, and provides agents that can dynamically reason with tools using either Google ADK or LangGraph.

This project transforms MCP tools into:

  • 🤖 Google ADK-based agents with streaming FastAPI or CLI interfaces
  • 🧠 LangGraph-based agents that use ReAct + streaming tool planning

🧱 Project Structure

mcp-agent-tool-adapter/
├── mcp_client/                # Core client implementation (modular)
│   ├── client.py              # MCPClient & MCPServer
│   ├── tool_loader.py         # High-level async loader
│   └── types.py               # Shared type definitions
├── app_client_adk.py         # Google ADK agent + CLI chat
├── app_client_langgraph.py   # LangGraph agent + ReAct CLI chat
├── mcp_config.json           # Example MCP tool config
├── requirements.txt          # Dependencies
└── README.md

🚀 Getting Started

☑️ Prerequisites

  • Python 3.10+

⚙️ Installation

# Clone this repository
❯ git clone https://github.com/serkanyasr/mcp-agent-tool-adapter
❯ cd mcp-agent-tool-adapter

# Install dependencies
❯ pip install -r requirements.txt

🤖 Usage

Run Google ADK CLI agent:

❯ python app_client_adk.py

Run LangGraph ReAct CLI agent:

❯ python app_client_langgraph.py

Ensure your mcp_config.json defines tools like:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modular-protocol/filesystem"]
    }
  }
}

🧠 Tool Architecture

MCP tools are connected to agents through MCPClient, which handles:

  • Tool server spawning (via subprocess)
  • Session management
  • Tool adaptation (langgraph or Google ADK)
  • Cleanup

You can dynamically swap agent type by changing tool_type to "google" or "langgraph" in your app.


🧪 Development / Contributing

  • Fork the repo and create feature branches.
  • Submit a PR with a description of your changes.
  • Tag @serkanyasr in issues or PRs.

We welcome contributions in:

  • 🧩 new MCP tool adapters
  • 🧠 multi-agent LangGraph use cases
  • 🛠️ OpenAPI / streaming support

🎗 License

This project is licensed under the MIT License.For more details, refer to the LICENSE file.


相关推荐

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Lists Tailwind CSS classes in monospaced font

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://appia.in
  • Siri Shortcut Finder – your go-to place for discovering amazing Siri Shortcuts with ease

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • tomoyoshi hirata
  • Sony α7IIIマニュアルアシスタント

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

  • pontusab
  • The Cursor & Windsurf community, find rules and MCPs

  • av
  • Effortlessly run LLM backends, APIs, frontends, and services with one command.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • modelcontextprotocol
  • Model Context Protocol Servers

    Reviews

    2 (1)
    Avatar
    user_qcX5JP2H
    2025-04-17

    The mcp-agent-tool-adapter is a phenomenal tool created by serkanyasr. It significantly simplifies integrating with MCP agents, saving time and effort for developers. With its seamless functionality and ease of use, it's an indispensable asset for any MCP application user. Highly recommend checking it out! Visit the link for more details: https://github.com/serkanyasr/langgraph-mcp-agents