Minor updates to REAMDE and usage examples

Author: hideya

CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [Unreleased]
+
+### Changed
+- Minor updates to REAMDE and usage examples
+
+
 ## [0.3.8] - 2025-09-03
 
 ### Fixed

README.md

@@ -96,6 +96,25 @@ const agent = createReactAgent({
 });
 ```
 
+The returned `cleanup` function properly handles resource cleanup:
+
+- Closes all MCP server connections concurrently and logs any cleanup failures
+- Continues cleanup of remaining servers even if some fail
+- Should always be called when done using the tools
+
+It is typically invoked in a finally block:
+
+```ts
+const { tools, cleanup } = await convertMcpToLangchainTools(mcpServers);
+
+try {
+  // Use tools with your LLM
+} finally {
+  // Always cleanup, even if errors occur
+  await cleanup();
+}
+```
+
 A minimal but complete working usage example can be found
 [in this example in the langchain-mcp-tools-ts-usage repo](https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/main/src/index.ts)
 
@@ -145,14 +164,6 @@ While MCP tools can return multiple content types (text, images, etc.), this lib
   [See below](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README.md#llm-provider-schema-compatibility) for details.
 - **Passing PATH Env Variable**: The library automatically adds the `PATH` environment variable to stdio server configrations if not explicitly provided to ensure servers can find required executables.
 
-## API docs
-
-Can be found [here](https://hideya.github.io/langchain-mcp-tools-ts/modules.html)
-
-## Building from Source
-
-See [README_DEV.md](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README_DEV.md) for details.
-
 ## Features
 
 ### `stderr` Redirection for Local MCP Server 
@@ -260,7 +271,7 @@ Streamable HTTP is the modern MCP transport that replaces the older HTTP+SSE tra
 
 ### Accessing Remote MCP Servers with OAuth Quickly
 
-If you need to use MCP servers that require OAuth quickly, consider using **"[mcp-remote](https://www.npmjs.com/package/mcp-remote)"**.
+If you need to use MCP servers that require OAuth, consider using **"[mcp-remote](https://www.npmjs.com/package/mcp-remote)"**.
 
 ```ts
     notionMCP: {
@@ -313,10 +324,18 @@ Test implementations are provided:
   - MCP client uses this library: [streamable-http-auth-test-client.ts](https://github.com/hideya/langchain-mcp-tools-ts/tree/main/testfiles/streamable-http-auth-test-client.ts)
   - Test MCP Server:  [streamable-http-auth-test-server.ts](https://github.com/hideya/langchain-mcp-tools-ts/tree/main/testfiles/streamable-http-auth-test-server.ts)
 
+## API docs
+
+Can be found [here](https://hideya.github.io/langchain-mcp-tools-ts/modules.html)
+
 ## Change Log
 
 Can be found [here](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/CHANGELOG.md)
 
+## Building from Source
+
+See [README_DEV.md](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README_DEV.md) for details.
+
 ## Appendix
 
 ### Troubleshooting
@@ -408,27 +427,6 @@ const { tools, cleanup } = await convertMcpToLangchainTools(
 - [Gemini API Schema Requirements](https://ai.google.dev/api/caching#Schema)
 - [Anthropic Tool Use](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview)
 
-
-### Resource Management
-
-The returned `cleanup` function properly handles resource cleanup:
-
-- Closes all MCP server connections concurrently
-- Logs any cleanup failures
-- Continues cleanup of remaining servers even if some fail
-- Should always be called when done using the tools
-
-```ts
-const { tools, cleanup } = await convertMcpToLangchainTools(mcpServers);
-
-try {
-  // Use tools with your LLM
-} finally {
-  // Always cleanup, even if errors occur
-  await cleanup();
-}
-```
-
 ### Debugging and Logging
 
 The library provides configurable logging to help debug connection and tool execution issues:
@@ -458,5 +456,5 @@ Available log levels: `"fatal" | "error" | "warn" | "info" | "debug" | "trace"`
 
 ### For Developers
 
-See [README_DEV.md](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README_DEV.md)
+See [./README_DEV.md](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README_DEV.md)
 for more information about development and testing.

testfiles/simple-usage.ts

@@ -109,6 +109,15 @@ export async function test(): Promise<void> {
       //   }
       // },
 
+      // // NOTE: comment out "fetch" when you use "notion".
+      // // They both have a tool named "fetch," which causes a conflict.
+      //
+      // // Run Notion remote MCP server via mcp-remote
+      // notion: {
+      //     "command": "npx",  // OAuth via "mcp-remote"
+      //     "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"],
+      // },
+      //
       // // The following Notion local MCP server is not recommended anymore?
       // // Refs:
       // // - https://developers.notion.com/docs/get-started-with-mcp
@@ -121,12 +130,6 @@ export async function test(): Promise<void> {
       //   }
       // },
 
-      // // Run Notion remote MCP server via mcp-remote
-      // notion: {
-      //     "command": "npx",
-      //     "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"],
-      // },
-
       // airtable: {
       //   command: "npx",
       //   "args": ["-y", "airtable-mcp-server"],
@@ -262,13 +265,12 @@ export async function test(): Promise<void> {
     // const query = "Tell me how LLMs work in a few sentences";
     // const query = "Read the news headlines on bbc.com";
     // const query = "Read and briefly summarize the LICENSE file";
-    // const query = "Tell me how many of directories in `.`";
+    // const query = "Tell me how many directories there are in `.`";
     // const query = "Tell me about my GitHub profile";
     // const query = "Make a new table in DB and put items apple and orange with counts 123 and 345 respectively, " +
     //               "then increment the coutns by 1, and show all the items in the table.";
-    // const query = "Use sequential thinking to arrange these events of backing bread " +
-    //               "in the correct sequence: baking, proofing, mixing, kneading, cooling";
-    // const query = "Open bbc.com page";
+    // const query = "Use sequential-thinking and plan a trip from Tokyo to San Francisco";
+    // const query = "Open the BBC.com page, then close it";
     // const query = "Tell me about my Notion account";
     // const query = "Tell me about my Airtable account";
     // const query = "What's the news from Tokyo today?";