https://github.com/hideya/langchain-mcp-tools-ts
Package intended to simplify the use of MCP server tools within LangChain
https://github.com/hideya/langchain-mcp-tools-ts
langchain langchain-typescript mcp mcp-client modelcontextprotocol nodejs npm-package tool-calling typescript
Last synced: 8 months ago
JSON representation
Package intended to simplify the use of MCP server tools within LangChain
- Host: GitHub
- URL: https://github.com/hideya/langchain-mcp-tools-ts
- Owner: hideya
- License: mit
- Created: 2025-01-06T06:05:01.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-18T04:08:16.000Z (9 months ago)
- Last Synced: 2025-01-18T05:18:43.799Z (9 months ago)
- Topics: langchain, langchain-typescript, mcp, mcp-client, modelcontextprotocol, nodejs, npm-package, tool-calling, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@h1deya/langchain-mcp-tools
- Size: 139 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCP To LangChain Tools Conversion Utility / TypeScript [](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/LICENSE) [](https://www.npmjs.com/package/@h1deya/langchain-mcp-tools)
This package is intended to simplify the use of
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
server tools with LangChain / TypeScript.
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/),
an open source technology
[announced by Anthropic](https://www.anthropic.com/news/model-context-protocol),
dramatically expands generative AI’s scope
by enabling external tool and resource integration, including
Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
Over 450 functional components available as MCP servers:
- [Glama’s list of Open-Source MCP servers](https://glama.ai/mcp/servers)
- [Smithery: MCP Server Registry](https://smithery.ai/)
- [awesome-mcp-servers](https://github.com/hideya/awesome-mcp-servers#Server-Implementations)
- [MCP Get Started/Example Servers](https://modelcontextprotocol.io/examples)
The goal of this utility is to make these 450+ MCP servers readily accessible from LangChain.
It contains a utility function `convertMcpToLangchainTools()`.
This async function handles parallel initialization of specified multiple MCP servers
and converts their available tools into an array of LangChain-compatible tools.
For detailed information on how to use this library, please refer to the following document:
- ["Supercharging LangChain: Integrating 450+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
A python equivalent of this utility is available
[here](https://pypi.org/project/langchain-mcp-tools)
## Prerequisites
- Node.js 16+
## Installation
```bash
npm i @h1deya/langchain-mcp-tools
```
## Quick Start
`convertMcpToLangchainTools()` utility function accepts MCP server configurations
that follow the same structure as
[Claude for Desktop](https://modelcontextprotocol.io/quickstart/user),
but only the contents of the `mcpServers` property,
and is expressed as a JS Object, e.g.:
```ts
const mcpServers: McpServersConfig = {
filesystem: {
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
},
fetch: {
command: 'uvx',
args: ['mcp-server-fetch']
}
};
const { tools, cleanup } = await convertMcpToLangchainTools(mcpServers);
```
This utility function initializes all specified MCP servers in parallel,
and returns LangChain Tools
([`tools: StructuredTool[]`](https://api.js.langchain.com/classes/_langchain_core.tools.StructuredTool.html))
by gathering available MCP tools from the servers,
and by wrapping them into LangChain tools.
It also returns an async callback function (`cleanup: McpServerCleanupFn`)
to be invoked to close all MCP server sessions when finished.
The returned tools can be used with LangChain, e.g.:
```ts
// import { ChatAnthropic } from '@langchain/anthropic';
const llm = new ChatAnthropic({ model: 'claude-3-5-haiku-latest' });
// import { createReactAgent } from '@langchain/langgraph/prebuilt';
const agent = createReactAgent({
llm,
tools
});
```
Find complete, minimal working usage examples
[here](https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/main/src/index.ts)
For hands-on experimentation with MCP server integration,
try [this LangChain application built with the utility](https://github.com/hideya/mcp-client-langchain-ts)
For detailed information on how to use this library, please refer to the following document:
["Supercharging LangChain: Integrating 450+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
## Limitations
Currently, only text results of tool calls are supported.