LangGraph Agents + MCP
Project Overview
LangChain-MCP-Adapters is a toolkit provided by LangChain AI that enables AI agents to interact with external tools and data sources through the Model Context Protocol (MCP). This project provides a user-friendly interface for deploying ReAct agents that can access various data sources and APIs through MCP tools.
Features
- Streamlit Interface: A user-friendly web interface for interacting with LangGraph
ReAct Agentwith MCP tools - Tool Management: Add, remove, and configure MCP tools through the UI (Smithery JSON format supported). This is done dynamically without restarting the application
- Streaming Responses: View agent responses and tool calls in real-time
- Conversation History: Track and manage conversations with the agent
MCP Architecture
The Model Context Protocol (MCP) consists of three main components:
-
MCP Host: Programs seeking to access data through MCP, such as Claude Desktop, IDEs, or LangChain/LangGraph.
-
MCP Client: A protocol client that maintains a 1:1 connection with the server, acting as an intermediary between the host and server.
-
MCP Server: A lightweight program that exposes specific functionalities through a standardized model context protocol, serving as the primary data source.
Quick Start with Docker
You can easily run this project using Docker without setting up a local Python environment.
Requirements (Docker Desktop)
Install Docker Desktop from the link below:
Run with Docker Compose
- Navigate to the
dockersdirectory
cd dockers
- Create a
.envfile with your API keys in the project root directory.
cp .env.example .env
Enter your obtained API keys in the .env file.
(Note) Not all API keys are required. Only enter the ones you need.
ANTHROPIC_API_KEY: If you enter an Anthropic API key, you can use "claude-3-7-sonnet-latest", "claude-3-5-sonnet-latest", "claude-3-haiku-latest" models.OPENAI_API_KEY: If you enter an OpenAI API key, you can use "gpt-4o", "gpt-4o-mini" models.LANGSMITH_API_KEY: If you enter a LangSmith API key, you can use LangSmith tracing.
ANTHROPIC_API_KEY=your_anthropic_api_key
OPENAI_API_KEY=your_openai_api_key
LANGSMITH_API_KEY=your_langsmith_api_key
LANGSMITH_TRACING=true
LANGSMITH_ENDPOINT=https://api.smith.langchain.com
LANGSMITH_PROJECT=LangGraph-MCP-Agents
When using the login feature, set USE_LOGIN to true and enter USER_ID and USER_PASSWORD.
USE_LOGIN=true
USER_ID=admin
USER_PASSWORD=admin123
If you don't want to use the login feature, set USE_LOGIN to false.
USE_LOGIN=false
- Select the Docker Compose file that matches your system architecture.
AMD64/x86_64 Architecture (Intel/AMD Processors)
# Run container
docker compose -f docker-compose.yaml up -d
ARM64 Architecture (Apple Silicon M1/M2/M3/M4)
# Run container
docker compose -f docker-compose-mac.yaml up -d
- Access the application in your browser at http://localhost:8585
(Note)
- If you need to modify ports or other settings, edit the docker-compose.yaml file before building.
Install Directly from Source Code
- Clone this repository
git clone https://github.com/teddynote-lab/langgraph-mcp-agents.git
cd langgraph-mcp-agents
- Create a virtual environment and install dependencies using uv
uv venv
uv pip install -r requirements.txt
source .venv/bin/activate # For Windows: .venv\Scripts\activate
- Create a
.envfile with your API keys (copy from.env.example)
cp .env.example .env
Enter your obtained API keys in the .env file.
(Note) Not all API keys are required. Only enter the ones you need.
ANTHROPIC_API_KEY: If you enter an Anthropic API key, you can use "claude-3-7-sonnet-latest", "claude-3-5-sonnet-latest", "claude-3-haiku-latest" models.OPENAI_API_KEY: If you enter an OpenAI API key, you can use "gpt-4o", "gpt-4o-mini" models.LANGSMITH_API_KEY: If you enter a LangSmith API key, you can use LangSmith tracing.
ANTHROPIC_API_KEY=your_anthropic_api_key
OPENAI_API_KEY=your_openai_api_key
LANGSMITH_API_KEY=your_langsmith_api_key
LANGSMITH_TRACING=true
LANGSMITH_ENDPOINT=https://api.smith.langchain.com
LANGSMITH_PROJECT=LangGraph-MCP-Agents
- (New) Use the login/logout feature
When using the login feature, set USE_LOGIN to true and enter USER_ID and USER_PASSWORD.
USE_LOGIN=true
USER_ID=admin
USER_PASSWORD=admin123
If you don't want to use the login feature, set USE_LOGIN to false.
USE_LOGIN=false
Usage
- Start the Streamlit application.
streamlit run app.py
-
The application will run in the browser and display the main interface.
-
Use the sidebar to add and configure MCP tools
Visit Smithery to find useful MCP servers.
First, select the tool you want to use.
Click the COPY button in the JSON configuration on the right.
Paste the copied JSON string in the Tool JSON section.
Click the Add Tool button to add it to the "Registered Tools List" section.
Finally, click the "Apply" button to apply the changes to initialize the agent with the new tools.
- Check the agent's status.
- Interact with the ReAct agent that utilizes the configured MCP tools by asking questions in the chat interface.
Hands-on Tutorial
For developers who want to learn more deeply about how MCP and LangGraph integration works, we provide a comprehensive Jupyter notebook tutorial:
- Link: MCP-HandsOn-KOR.ipynb
This hands-on tutorial covers:
- MCP Client Setup - Learn how to configure and initialize the MultiServerMCPClient to connect to MCP servers
- Local MCP Server Integration - Connect to locally running MCP servers via SSE and Stdio methods
- RAG Integration - Access retriever tools using MCP for document retrieval capabilities
- Mixed Transport Methods - Combine different transport protocols (SSE and Stdio) in a single agent
- LangChain Tools + MCP - Integrate native LangChain tools alongside MCP tools
This tutorial provides practical examples with step-by-step explanations that help you understand how to build and integrate MCP tools into LangGraph agents.
License
MIT License