Module●Since v0.0
mcp_tools
MCP (Model Context Protocol) tools loader for deepagents CLI.
This module provides async functions to load and manage MCP servers using
langchain-mcp-adapters, supporting Claude Desktop style JSON configs.
It also supports automatic discovery of .mcp.json files from user-level
and project-level locations.
Attributes
Functions
functionfunctionfunctionfunctionfunctionfunctionfunctionfunction
load_mcp_config
Load and validate MCP configuration from JSON file.
Supports multiple server types:
- stdio: Process-based servers with
command,args,envfields (default) - sse: Server-Sent Events servers with
type: "sse",url, and optionalheaders - http: HTTP-based servers with
type: "http",url, and optionalheaders
discover_mcp_configs
Find MCP config files from standard locations.
Checks three paths in precedence order (lowest to highest):
~/.deepagents/.mcp.json(user-level global)<project-root>/.deepagents/.mcp.json(project subdir)<project-root>/.mcp.json(project root, Claude Code compat)
Project root is determined by find_project_root(), falling back to CWD.
classify_discovered_configs
Split discovered config paths into user-level and project-level.
User-level configs live under ~/.deepagents/. Everything else is
considered project-level.
extract_stdio_server_commands
Extract stdio server entries from a parsed MCP config.
merge_mcp_configs
Merge multiple MCP config dicts by server name.
Later entries override earlier ones for the same server name
(simple dict.update on mcpServers).
load_mcp_config_lenient
Load an MCP config file, returning None on any error.
Wraps load_mcp_config with lenient error handling suitable for
auto-discovery. Missing files are skipped silently; parse and validation
errors are logged as warnings.
get_mcp_tools
Load MCP tools from configuration file with stateful sessions.
Supports multiple server types:
- stdio: Spawns MCP servers as subprocesses with persistent sessions
- sse/http: Connects to remote MCP servers via URL
For stdio servers, this creates persistent sessions that remain active
across tool calls, avoiding server restarts. Sessions are managed by
MCPSessionManager and should be cleaned up with
session_manager.cleanup() when done.
resolve_and_load_mcp_tools
Resolve MCP config and load tools.
Auto-discovers configs from standard locations and merges them.
When explicit_config_path is provided it is added as the
highest-precedence source (errors in that file are fatal).
Classes
classclassclass
MCPToolInfo
Metadata for a single MCP tool.
MCPServerInfo
Metadata for a connected MCP server and its tools.
MCPSessionManager
Manages persistent MCP sessions for stateful stdio servers.
This manager creates and maintains persistent sessions for stdio MCP servers, preventing server restarts on every tool call. Sessions are kept alive until explicitly cleaned up.