langchain-mcp-adapters

一行代码把 MCP 工具接进 LangChain Agent

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 499 👀 关注 21 ⚠️ 作者已归档（停止维护）

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3645

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源免费，遵循 MIT 许可证

项目预览

langchain-mcp-adapters 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开发框架

开发团队langchain-ai

官网地址https://docs.langchain.com/oss/python/langchain/mcp

GitHubhttps://github.com/langchain-ai/langchain-mcp-adapters

定价模式🏷️完全免费

价格说明开源免费，遵循 MIT 许可证

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型langchain,langgraph,mcp,python,tools

GitHub 星标★ 3645

上线时间2025-02-07 00:00:00

代码更新2026-09-16

仓库体积1.4 MB

本站数据更新2026-11-03

维护状态维护中

收录时间2026-09-12

浏览次数1

项目介绍

langchain-mcp-adapters 是 LangChain 官方推出的适配层，用于把 Anthropic 提出的 MCP（Model Context Protocol）服务器无缝接入 LangChain 与 LangGraph 生态。MCP 定义了一套标准协议，让 AI 应用能以统一方式发现和调用外部工具、数据源与提示模板；但 LangChain 的工具抽象与 MCP 的协议格式并不一致。本项目解决这一鸿沟：它提供客户端封装，可将任意 MCP 服务器暴露的工具自动转换为 LangChain 的 StructuredTool，从而直接在 Agent、链或 LangGraph 工作流中调用。核心能力包括多服务器会话管理、stdio 与 SSE/HTTP 传输支持、工具列表动态加载与调用、资源与提示读取，并支持在 LangGraph 节点中复用同一会话。对已有 LangChain 项目来说，它能低成本接入不断增长的 MCP 工具生态。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 3645

技术标签

langchain langgraph mcp python tools

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

Python 环境（需可运行 pip）
已安装 langgraph 与 langchain（Quickstart 中一并安装）
使用 OpenAI 模型时需准备 OPENAI_API_KEY
接入 SSE / HTTP(streamable_http) 传输的 MCP 服务器时需准备对应 headers 认证信息

安装与启动步骤

1了解维护状态

该仓库已不再主动维护，MCP 支持已迁入 langchain.mcp 命名空间，新项目建议直接迁移。
2安装适配器包

最小安装，只装本适配层本身。注意包名结尾是多数的 adapters。
```
pip install langchain-mcp-adapters
```
3安装完整依赖

按 Quickstart 一次性装齐适配器、LangGraph 与带 OpenAI 支持的 LangChain。
```
pip install langchain-mcp-adapters langgraph "langchain[openai]"
```
4配置模型密钥

设置 OpenAI 密钥到环境变量，把示例值换成你自己的真实 key。
```
export OPENAI_API_KEY=sk-xxxxxxxx
```
5Windows 配置密钥

Windows PowerShell 下用 $env: 语法设置同名环境变量。
```
$env:OPENAI_API_KEY="sk-xxxxxxxx"
```
6迁移到新包(推荐)

README 要求迁移到 langchain[mcp] 以获得后续开发、修复与支持。
```
pip install "langchain[mcp]"
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	供 LangGraph agent 调用 OpenAI 模型使用	`sk-xxxxxxxx`
`headers`	否	连接 MCP 服务器时传入的自定义请求头，用于认证或追踪	`{"Authorization": "Bearer sk-xxxxxxxx"}`