📝 docs(README): update transport methods and tool registry

- clarify support for multiple MCP transport methods in both README_en.md and README_zh.md
- add examples for MCP transport configuration including StreamableHttpTransport and FastMCP
- enhance OpenAPI integration section with auto-discovery explanation and better examples
- refine descriptions of hub tools with expanded functionality details
- introduce community contribution section in both README files

Author: Oaklight

README_en.md

@@ -1,6 +1,6 @@
 # ToolRegistry
 
-[中文版](README_zh.md)
+[English Version](README_en.md) | [中文版](README_zh.md)
 
 A Python library for managing and executing tools in a structured way.
 
@@ -10,7 +10,8 @@ A Python library for managing and executing tools in a structured way.
 - JSON Schema generation for tool parameters
 - Tool execution and result handling
 - Support for both synchronous and asynchronous tools
-- Support [MCP sse](https://toolregistry.lab.oaklight.cn/mcp.html), [OpenAPI](https://toolregistry.lab.oaklight.cn/openapi.html) tools
+- Support multiple MCP transport methods: stdio, streamable HTTP, SSE, WebSocket
+- Support [OpenAPI](https://toolregistry.lab.oaklight.cn/openapi.html) tools
 
 ## Full Documentation
 
@@ -91,38 +92,53 @@ For more usage examples, please refer to [Documentation - Usage](https://toolreg
 The ToolRegistry provides first-class support for MCP (Model Context Protocol) tools with multiple transport options:
 
 ```python
-# Can be URL string, path to script, or transport instance
-transport = "http://localhost:8000/sse"
-transport = "examples/mcp_related/mcp_servers/math_server.py"
+# transport can be a URL string, script path, transport instance, or MCP instance.
+transport = "https://mcphub.url/mcp"  # Streamable HTTP MCP
+transport = "http://localhost:8000/sse/test_group"  # Legacy HTTP+SSE
+transport = "examples/mcp_related/mcp_servers/math_server.py"  # Local path
+transport = {
+    "mcpServers": {
+        "make_mcp": {
+            "command": f"{Path.home()}/mambaforge/envs/toolregistry_dev/bin/python",
+            "args": [
+                f"{Path.home()}/projects/toolregistry/examples/mcp_related/mcp_servers/math_server.py"
+            ],
+            "env": {},
+        }
+    }
+}  # MCP configuration dictionary example
+transport = FastMCP(name="MyFastMCP")  # FastMCP instance
+transport = StreamableHttpTransport(url="https://mcphub.example.com/mcp", headers={"Authorization": "Bearer token"})  # Transport instance with custom headers
 
 registry.register_from_mcp(transport)
 
-# Get all tools JSON including MCP tools
+# Get all tools' JSON, including MCP tools
 tools_json = registry.get_tools_json()
 ```
 
-Supported transport types:
-
-- URL string (http://, https://, ws://, wss://)
-- Path to script file (.py, .js)
-- Existing ClientTransport instance
-- FastMCP instance
-
 ## OpenAPI Integration
 
 ToolRegistry supports integration with OpenAPI for interacting with tools using a standardized API interface:
 
 ```python
-registry.register_from_openapi("http://localhost:8000/") # by providing baseurl
-registry.register_from_openapi("./openapi_spec.json", "http://localhost/") # by providing local OpenAPI spec file and base url
+registry.register_from_openapi("http://localhost:8000/")  # Providing base URL
+registry.register_from_openapi("./openapi_spec.json", "http://localhost/")  # Providing local OpenAPI specification file and base URL
 
-# Get all tools JSON including OpenAPI tools
+# Get all tools' JSON, including OpenAPI tools
 tools_json = registry.get_tools_json()
 ```
 
-## Registering Hub Tools
+### Note
+
+When only providing a base URL, ToolRegistry will attempt a "best effort" auto-discovery to find the OpenAPI specification file (e.g., via `http://<base_url>/openapi.json` or `http://<base_url>/swagger.json`). If discovery fails, ensure the provided URL is correct or download the OpenAPI specification file yourself and register using the file + base URL method:
+
+```python
+registry.register_from_openapi("./openapi_spec.json", "http://localhost/")
+```
+
+## Registering Class Tools
 
-Hub tools are registered to ToolRegistry using the `register_from_class` method. This allows developers to extend the functionality of ToolRegistry by creating custom tool classes with reusable methods.
+Class tools are registered to ToolRegistry using the `register_from_class` method. This allows developers to extend the functionality of ToolRegistry by creating custom tool classes with reusable methods.
 
 Example:
 
@@ -154,17 +170,15 @@ print(registry["instance_example.greet"]("Alice"))  # Hello, Alice! I'm Bob.
 
 ### Hub Tools
 
-[Latest Available Tools](src/toolregistry/hub/)
-
-Hub tools encapsulate commonly used functionalities as methods in classes. These tools are grouped for better organization and reusability.
+[Available Tools](src/toolregistry/hub/)
 
-Examples of available hub tools include:
+Hub tools encapsulate commonly used functionalities as methods in classes. Examples of available hub tools include:
 
 - **Calculator**: Basic arithmetic, scientific operations, statistical functions, financial calculations, and more.
-- **FileOps**: File manipulation operations like diff generation, patching, and verification.
-- **Filesystem**: Comprehensive file system operations such as directory listing, file reading/writing, and path manipulation.
-- **UnitConverter**: Extensive unit conversion tools for temperature, length, weight, and more.
-- **WebSearch**: Web search functionality supporting multiple search engines including SearxNG and Google.
+- **FileOps**: File manipulation like diff generation, patching, verification, merging, and splitting.
+- **Filesystem**: Comprehensive file system operations such as directory listing, file read/write, path normalization, and querying file attributes.
+- **UnitConverter**: Extensive unit conversions such as temperature, length, weight, volume, etc.
+- **WebSearch**: Web search functionality supporting multiple engines like SearxNG and Google.
 
 To register hub tools:
 
@@ -180,6 +194,10 @@ print(registry.get_available_tools())
 # Output: ['Calculator.add', 'Calculator.subtract', ..., 'Calculator.multiply', ...]
 ```
 
+### Community Contribution
+
+We welcome community contributions of new tool classes to ToolRegistry! If you have designs or implementations for other commonly used tools, feel free to submit them through a Pull Request on the [GitHub Repository](https://github.com/yourrepository/toolregistry). Your contributions will help expand the diversity and usability of the tools.
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

README_zh.md

@@ -1,6 +1,6 @@
 # ToolRegistry
 
-[English Version](README_en.md)
+[English Version](README_en.md) | [中文版](README_zh.md)
 
 一个用于以结构化方式管理和执行工具的 Python 库。
 
@@ -10,7 +10,8 @@
 - 工具参数的 JSON Schema 生成
 - 工具执行与结果处理
 - 支持同步和异步工具
-- 支持 [MCP sse](https://toolregistry.lab.oaklight.cn/mcp.html)、[OpenAPI](https://toolregistry.lab.oaklight.cn/openapi.html) 工具
+- 支持多种 MCP 传输方式: stdio, streamable http, sse, websocket
+- 支持 [OpenAPI](https://toolregistry.lab.oaklight.cn/openapi.html) 工具
 
 ## 完整文档
 
@@ -91,38 +92,52 @@ print(add_result) # 9
 ToolRegistry 提供对 MCP（模型上下文协议）工具的一流支持：
 
 ```python
-# 可以是URL字符串、脚本路径或transport实例
-transport = "http://localhost:8000/sse"
-transport = "examples/mcp_related/mcp_servers/math_server.py"
+# transport 可以是 URL 字符串、脚本路径、transport 实例或 MCP 实例。
+transport = "https://mcphub.url/mcp"  # 使用 HTTP Streamable MCP
+transport = "http://localhost:8000/sse/test_group"  # 使用 legacy HTTP+sse
+transport = "examples/mcp_related/mcp_servers/math_server.py"  # 本地路径
+transport = {
+    "mcpServers": {
+        "make_mcp": {
+            "command": f"{Path.home()}/mambaforge/envs/toolregistry_dev/bin/python",
+            "args": [
+                f"{Path.home()}/projects/toolregistry/examples/mcp_related/mcp_servers/math_server.py"
+            ],
+            "env": {},
+        }
+    }
+} # 示例 MCP 配置字典
+transport = FastMCP(name="MyFastMCP")  # 使用 FastMCP 实例
+transport = StreamableHttpTransport(url="https://mcphub.example.com/mcp", headers={"Authorization": "Bearer token"})  # 使用自定义头的 transport 实例
 
 registry.register_from_mcp(transport)
 
 # 获取所有工具的 JSON，包括 MCP 工具
 tools_json = registry.get_tools_json()
-```
-
-支持的transport类型：
-
-- URL字符串 (http://, https://, ws://, wss://)
-- 脚本文件路径 (.py, .js)
-- 现有的ClientTransport实例
-- FastMCP实例
 
 ## OpenAPI 集成
 
 ToolRegistry 支持与 OpenAPI 集成，以使用标准化 API 接口与工具交互：
 
 ```python
-registry.register_from_openapi("http://localhost:8000/") # 提供基础 URL
-registry.register_from_openapi("./openapi_spec.json", "http://localhost/") # 提供本地 OpenAPI 规范文件和基础 URL
+registry.register_from_openapi("http://localhost:8000/")  # 提供基础 URL
+registry.register_from_openapi("./openapi_spec.json", "http://localhost/")  # 提供本地 OpenAPI 规范文件和基础 URL
 
 # 获取所有工具的 JSON，包括 OpenAPI 工具
 tools_json = registry.get_tools_json()
 ```
 
-## 注册 Hub 工具
+### 注意事项
+
+在仅提供基础 URL 的情况下，ToolRegistry 会尝试 "best effort" 自动发现 OpenAPI 规范文件（例如通过 `http://<base_url>/openapi.json` 或 `http://<base_url>/swagger.json`）。如果发现失败，请检查所提供的 URL 是否正确，或者自行下载 OpenAPI 规范文件并使用文件 + 基础 URL 的方式注册工具。例如：
+
+```python
+registry.register_from_openapi("./openapi_spec.json", "http://localhost/")
+```
+
+## 注册 Class 工具
 
-Hub 工具通过 `register_from_class` 方法注册到 ToolRegistry。这允许开发人员通过创建具有可重用方法的自定义工具类来扩展 ToolRegistry 的功能。
+Class 工具通过 `register_from_class` 方法注册到 ToolRegistry。这允许开发人员通过创建具有可重用方法的自定义工具类来扩展 ToolRegistry 的功能。
 
 示例：
 
@@ -204,6 +219,10 @@ print(registry.get_available_tools())
 # 输出：['Calculator.add', 'Calculator.subtract', ..., 'Calculator.multiply', ...]
 ```
 
+### 社区贡献
+
+我们欢迎社区贡献新的工具类到 ToolRegistry！如果您有其他常用工具类的设计或实现，欢迎通过 Pull Request 提交到 [GitHub 仓库](https://github.com/yourrepository/toolregistry)。您的贡献将帮助拓展工具的多样性和适用性。
+
 ## 许可证
 
 此项目根据 MIT 许可证授权 - 详情请参阅 [LICENSE](LICENSE) 文件。