This simple Model Context Protocol (MCP) client demonstrates the use of MCP server tools by LangChain ReAct Agent.
It leverages a utility function convert_mcp_to_langchain_tools() from
langchain_mcp_tools.
This function handles parallel initialization of specified multiple MCP servers
and converts their available tools into a list of LangChain-compatible tools
(list[BaseTool]).
OpenAI's gpt-5.4-mini is used as the LLM.
For convenience, code for Anthropic's, Google GenAI's and xAI's LLMs are also included and commented out.
A bit more realistic (conversational) MCP Client is available here
A typescript equivalent of this MCP client is available here
- Python 3.11+
- [optional]
uv(uvx) installed to run Python package-based MCP servers - [optional] npm 7+ (
npx) to run Node.js package-based MCP servers - LLM API keys from OpenAI, Anthropic, Google GenAI, and/or xAI as needed
-
Install dependencies:
make install
-
Setup API key:
cp .env.template .env
- Update
.envas needed. .gitignoreis configured to ignore.envto prevent accidental commits of the credentials.
- Update
-
Run the app:
make start
It takes a while on the first run.