LANGGRAPH-MCP-AGENTS

Created By

serkanyasra year ago

Transforms MCP tools into collaborative agents using the LangGraph framework.

# mcp

# agents

Overview Content Tools Comments

Content

LANGGRAPH-MCP-AGENTS

From Protocol to Intelligence: Powering Agents with MCP.

repo-top-language repo-language-count

📍 Overview

LangGraph MCP Agents is an experimental project that aims to transform tools defined under MCP (Modular Communication Protocol) into autonomous agents using the LangGraph framework.

The aim of this project is to transform tools designed in accordance with the MCP protocol (e.g. tools with tasks such as planning, coding, execution, etc.) into agents running on the LangGraph infrastructure and to provide effective task sharing and collaboration between these agents.

https://github.com/user-attachments/assets/e7c7e012-06aa-4a4e-a4cd-103141efed33

📁 Project Structure

└── langgraph-mcp-agents/
    ├── LICENCE
    ├── README.md
    ├── app_cli.py
    ├── mcp_client.py
    ├── mcp_config.json
    └── requirements.txt

📂 Project Index

LANGGRAPH-MCP-AGENTS/

__root__

mcp_client.py - MCPClient and MCPServer are the main classes in mcp_client.py
- MCPClient manages connections to multiple MCP servers, loads server configurations, starts servers, initializes tools, and handles resource cleanup
- MCPServer represents an individual server connection, manages tool execution, and handles cleanup operations
- The file is crucial for server communication and tool management in the project.
app_cli.py - App_cli.py is a command-line interface for a chatbot application that leverages the OpenAI language model
- It initializes the AI agent, accepts user input, and generates AI responses in real-time
- The script also handles server configurations, manages conversation history, and provides error handling and debugging support.
requirements.txt - Requirements.txt manages the necessary dependencies for the project
- It ensures the correct versions of libraries such as mcp, langgraph, langchain, python-dotenv, langchain-mcp-adapters, and rich are installed
- This contributes to the stability and reproducibility of the codebase across different environments.
mcp_config.json - Mcp_config.json configures the Model Context Protocol servers, specifying the commands and arguments for different server types: filesystem, SQLite, and memory
- It enables the project to interact with various data storage systems, enhancing its flexibility and adaptability to diverse environments.
LICENCE - The LICENCE file establishes the legal framework for the project, granting users the right to freely use, modify, and distribute the software under the MIT License
- It also disclaims warranties and limits liability, ensuring the software is provided "as is"
- This file is crucial for defining the terms of use and distribution of the software.

🚀 Getting Started

☑️ Prerequisites

Before getting started with langgraph-mcp-agents, ensure your runtime environment meets the following requirements:

Programming Language: Python
Package Manager: Pip

⚙️ Installation

Install langgraph-mcp-agents using one of the following methods:

Build from source:

Clone the langgraph-mcp-agents repository:

❯ git clone https://github.com/serkanyasr/langgraph-mcp-agents

Navigate to the project directory:

❯ cd langgraph-mcp-agents

Install the project dependencies:

Using pip

❯ pip install -r requirements.txt

🤖 Usage

Run langgraph-mcp-agents using the following command: Using pip

❯ python {entrypoint}

🔰 Contributing

💬 Join the Discussions: Share your insights, provide feedback, or ask questions.
🐛 Report Issues: Submit bugs found or log feature requests for the langgraph-mcp-agents project.
💡 Submit Pull Requests: Review open PRs, and submit your own PRs.

Contributing Guidelines

Fork the Repository: Start by forking the project repository to your github account.
Clone Locally: Clone the forked repository to your local machine using a git client.
```
git clone https://github.com/serkanyasr/langgraph-mcp-agents
```
Create a New Branch: Always work on a new branch, giving it a descriptive name.
```
git checkout -b new-feature-x
```
Make Your Changes: Develop and test your changes locally.
Commit Your Changes: Commit with a clear message describing your updates.
```
git commit -m 'Implemented new feature x.'
```
Push to github: Push the changes to your forked repository.
```
git push origin new-feature-x
```
Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!

Contributor Graph

🎗 License

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Tavily Mcp

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

DeepChatYour AI Partner on Desktop

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

ChatWiseThe second fastest AI chatbot™

Amap Maps高德地图官方 MCP Server

CursorThe AI Code Editor

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Playwright McpPlaywright MCP server

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

Serper MCP ServerA Serper MCP Server

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

WindsurfThe new purpose-built IDE to harness magic

mcp_client.py	- MCPClient and MCPServer are the main classes in mcp_client.py - MCPClient manages connections to multiple MCP servers, loads server configurations, starts servers, initializes tools, and handles resource cleanup - MCPServer represents an individual server connection, manages tool execution, and handles cleanup operations - The file is crucial for server communication and tool management in the project.
app_cli.py	- App_cli.py is a command-line interface for a chatbot application that leverages the OpenAI language model - It initializes the AI agent, accepts user input, and generates AI responses in real-time - The script also handles server configurations, manages conversation history, and provides error handling and debugging support.
requirements.txt	- Requirements.txt manages the necessary dependencies for the project - It ensures the correct versions of libraries such as mcp, langgraph, langchain, python-dotenv, langchain-mcp-adapters, and rich are installed - This contributes to the stability and reproducibility of the codebase across different environments.
mcp_config.json	- Mcp_config.json configures the Model Context Protocol servers, specifying the commands and arguments for different server types: filesystem, SQLite, and memory - It enables the project to interact with various data storage systems, enhancing its flexibility and adaptability to diverse environments.
LICENCE	- The LICENCE file establishes the legal framework for the project, granting users the right to freely use, modify, and distribute the software under the MIT License - It also disclaims warranties and limits liability, ensuring the software is provided "as is" - This file is crucial for defining the terms of use and distribution of the software.