chuk-tool-processor 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

{chuk_tool_processor-0.1.2.dist-info → chuk_tool_processor-0.1.4.dist-info}/METADATA

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: chuk-tool-processor
-Version: 0.1.2
+Version: 0.1.4
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
+Requires-Dist: chuk-mcp>=0.1.12
 Requires-Dist: dotenv>=0.9.9
 Requires-Dist: openai>=1.76.0
 Requires-Dist: pydantic>=2.11.3
@@ -21,6 +22,7 @@ The CHUK Tool Processor is a Python library designed to handle the execution of
 2. **Executing tools** with proper isolation and error handling
 3. **Managing tool executions** with retry logic, caching, and rate limiting
 4. **Monitoring tool usage** with comprehensive logging
+5. **MCP (Model Context Protocol) Integration** for remote tool execution
 
 ## Features
 
@@ -34,6 +36,7 @@ The CHUK Tool Processor is a Python library designed to handle the execution of
 - **Retry Logic**: Automatically retry transient failures with exponential backoff
 - **Structured Logging**: Comprehensive logging system for debugging and monitoring
 - **Plugin Discovery**: Dynamically discover and load plugins from packages
+- **MCP Integration**: Connect to and execute remote tools via Model Context Protocol
 
 ## Installation
 
@@ -101,6 +104,159 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+## MCP Integration
+
+The CHUK Tool Processor supports Model Context Protocol (MCP) for connecting to remote tool servers. This enables distributed tool execution and integration with third-party services.
+
+### MCP with Stdio Transport
+
+```python
+import asyncio
+from chuk_tool_processor.mcp import setup_mcp_stdio
+
+async def main():
+    # Configure MCP server
+    config_file = "server_config.json"
+    servers = ["echo", "calculator", "search"]
+    server_names = {0: "echo", 1: "calculator", 2: "search"}
+    
+    # Setup MCP with stdio transport
+    processor, stream_manager = await setup_mcp_stdio(
+        config_file=config_file,
+        servers=servers,
+        server_names=server_names,
+        namespace="mcp",  # All tools will be registered under this namespace
+        enable_caching=True,
+        enable_retries=True
+    )
+    
+    # Process text with MCP tool calls
+    llm_text = """
+    Let me echo your message using the MCP server.
+    
+    <tool name="mcp.echo" args='{"message": "Hello from MCP!"}'/>
+    """
+    
+    results = await processor.process_text(llm_text)
+    
+    for result in results:
+        print(f"Tool: {result.tool}")
+        print(f"Result: {result.result}")
+    
+    # Clean up
+    await stream_manager.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+### MCP Server Configuration
+
+Create a server configuration file (`server_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "echo": {
+      "command": "uv",
+      "args": ["--directory", "/path/to/echo-server", "run", "src/echo_server/main.py"]
+    },
+    "calculator": {
+      "command": "node",
+      "args": ["/path/to/calculator-server/index.js"]
+    },
+    "search": {
+      "command": "python",
+      "args": ["/path/to/search-server/main.py"]
+    }
+  }
+}
+```
+
+### Namespaced Tool Access
+
+MCP tools are automatically registered in both their namespace and the default namespace:
+
+```python
+# These are equivalent:
+<tool name="echo" args='{"message": "Hello"}'/>
+<tool name="mcp.echo" args='{"message": "Hello"}'/>
+```
+
+### MCP with SSE Transport
+
+```python
+import asyncio
+from chuk_tool_processor.mcp import setup_mcp_sse
+
+async def main():
+    # Configure SSE servers
+    sse_servers = [
+        {
+            "name": "weather",
+            "url": "https://api.example.com/sse/weather",
+            "api_key": "your_api_key"
+        },
+        {
+            "name": "geocoding",
+            "url": "https://api.example.com/sse/geocoding"
+        }
+    ]
+    
+    # Setup MCP with SSE transport
+    processor, stream_manager = await setup_mcp_sse(
+        servers=sse_servers,
+        server_names={0: "weather", 1: "geocoding"},
+        namespace="remote",
+        enable_caching=True
+    )
+    
+    # Process tool calls
+    llm_text = """
+    Get the weather for New York.
+    
+    <tool name="remote.weather" args='{"location": "New York", "units": "imperial"}'/>
+    """
+    
+    results = await processor.process_text(llm_text)
+    
+    await stream_manager.close()
+```
+
+### MCP Stream Manager
+
+The `StreamManager` class handles all MCP communication:
+
+```python
+from chuk_tool_processor.mcp.stream_manager import StreamManager
+
+# Create and initialize
+stream_manager = await StreamManager.create(
+    config_file="config.json",
+    servers=["echo", "search"],
+    transport_type="stdio"
+)
+
+# Get available tools
+tools = stream_manager.get_all_tools()
+for tool in tools:
+    print(f"Tool: {tool['name']}")
+
+# Get server information
+server_info = stream_manager.get_server_info()
+for server in server_info:
+    print(f"Server: {server['name']}, Status: {server['status']}")
+
+# Call a tool directly
+result = await stream_manager.call_tool(
+    tool_name="echo",
+    arguments={"message": "Hello"}
+)
+
+# Clean up
+await stream_manager.close()
+```
+
 ## Advanced Usage
 
 ### Using Decorators for Tool Configuration
@@ -259,11 +415,16 @@ The tool processor has several key components organized into a modular structure
    - `plugins/discovery.py`: Plugin discovery mechanism
    - `plugins/parsers/`: Parser plugins for different formats
 
-5. **Utils**: Shared utilities
+5. **MCP Integration**: Model Context Protocol support
+   - `mcp/stream_manager.py`: Manages MCP server connections
+   - `mcp/transport/`: Transport implementations (stdio, SSE)
+   - `mcp/setup_mcp_*.py`: Easy setup functions for MCP integration
+
+6. **Utils**: Shared utilities
    - `utils/logging.py`: Structured logging system
    - `utils/validation.py`: Argument and result validation
 
-6. **Core**: Central components
+7. **Core**: Central components
    - `core/processor.py`: Main processor for handling tool calls
    - `core/exceptions.py`: Exception hierarchy
 
@@ -274,6 +435,8 @@ The repository includes several example scripts:
 - `examples/tool_registry_example.py`: Demonstrates tool registration and usage
 - `examples/plugin_example.py`: Shows how to create and use custom plugins
 - `examples/tool_calling_example_usage.py`: Basic example demonstrating tool execution
+- `examples/mcp_stdio_example.py`: MCP stdio transport demonstration
+- `examples/mcp_stdio_example_calling_usage.py`: Complete MCP integration example
 
 Run examples with:
 
@@ -287,6 +450,9 @@ uv run examples/plugin_example.py
 # Tool execution example
 uv run examples/tool_calling_example_usage.py
 
+# MCP example
+uv run examples/mcp_stdio_example.py
+
 # Enable debug logging
 LOGLEVEL=DEBUG uv run examples/tool_calling_example_usage.py
 ```

{chuk_tool_processor-0.1.2.dist-info → chuk_tool_processor-0.1.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-chuk_tool_processor/__init__.py,sha256=a4pDi8hta4hjhijLGcv3vlWL8iu3F9EynkmB3si7-hg,33
+chuk_tool_processor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 chuk_tool_processor/core/__init__.py,sha256=slM7pZna88tyZrF3KtN22ApYyCqGNt5Yscv-knsLOOA,38
 chuk_tool_processor/core/exceptions.py,sha256=h4zL1jpCY1Ud1wT8xDeMxZ8GR8ttmkObcv36peUHJEA,1571
 chuk_tool_processor/core/processor.py,sha256=ud7ezONnUFh_aDSapiBGNx-LtZfhAFpYjFuw2m_tFXk,10165
@@ -16,6 +16,16 @@ chuk_tool_processor/logging/context.py,sha256=hQFWGeraHX3DM28JDSiIuhQqep6TBfo1ua
 chuk_tool_processor/logging/formatter.py,sha256=4pO-fLULkD3JPLjZOSiOZPGsjV3c4Ztr5ySda1RAvi4,1754
 chuk_tool_processor/logging/helpers.py,sha256=Fk32BuecWZdyrmv8U0lh4W0AdNx4-gKcCaWBdId_rlI,3569
 chuk_tool_processor/logging/metrics.py,sha256=ti_owuslT-x9cjcbP-_j7jivrlyY-Vb41mVhU-6W-2M,1537
+chuk_tool_processor/mcp/__init__.py,sha256=vR9HHxLpXlKTIIwJJRr3QTmZegcdedR1YKyb46j6FIM,689
+chuk_tool_processor/mcp/mcp_tool.py,sha256=TvZEudgQvaev2jaPw6OGsqAR5GNu6_cPaUCgqiT5ogU,1504
+chuk_tool_processor/mcp/register_mcp_tools.py,sha256=ofE7pEn6sKDH8HWvNamVOaXsitLOaG48M5GhcpqCBbs,2801
+chuk_tool_processor/mcp/setup_mcp_sse.py,sha256=Ep2IKRdH1Y299bCxt9G0NtwnsvguYP6mpraZyUJ8OKU,2643
+chuk_tool_processor/mcp/setup_mcp_stdio.py,sha256=NjTvAFqQHxxN3XubsTgYY3lTrvPVWlnwCzkzbz7WE_M,2747
+chuk_tool_processor/mcp/stream_manager.py,sha256=qIWzsQCTlu1SQQBExAdvBHGB3T5isQDyMhj29WkfbKQ,11779
+chuk_tool_processor/mcp/transport/__init__.py,sha256=7QQqeSKVKv0N9GcyJuYF0R4FDZeooii5RjggvFFg5GY,296
+chuk_tool_processor/mcp/transport/base_transport.py,sha256=1E29LjWw5vLQrPUDF_9TJt63P5dxAAN7n6E_KiZbGUY,3427
+chuk_tool_processor/mcp/transport/sse_transport.py,sha256=bryH9DOWOn5qr6LsimTriukDC4ix2kuRq6bUv9qOV20,7645
+chuk_tool_processor/mcp/transport/stdio_transport.py,sha256=lFXL7p8ca4z_J0RBL8UCHrQ1UH7C2-LbC0tZhpya4V4,7763
 chuk_tool_processor/models/__init__.py,sha256=TC__rdVa0lQsmJHM_hbLDPRgToa_pQT_UxRcPZk6iVw,40
 chuk_tool_processor/models/execution_strategy.py,sha256=ZPHysmKNHqJmahTtUXAbt1ke09vxy7EhZcsrwTdla8o,508
 chuk_tool_processor/models/tool_call.py,sha256=RZOnx2YczkJN6ym2PLiI4CRzP2qU_5hpMtHxMcFOxY4,298
@@ -41,7 +51,7 @@ chuk_tool_processor/registry/providers/__init__.py,sha256=_0dg4YhyfAV0TXuR_i4ewX
 chuk_tool_processor/registry/providers/memory.py,sha256=29aI5uvykjDmn9ymIukEdUtmTC9SXOAsDu9hw36XF44,4474
 chuk_tool_processor/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 chuk_tool_processor/utils/validation.py,sha256=7ezn_o-3IHDrzOD3j6ttsAn2s3zS-jIjeBTuqicrs6A,3775
-chuk_tool_processor-0.1.2.dist-info/METADATA,sha256=rIz9dpGciPSIx2rF-7ReK7WtGvFkmRpZkBGzrrjsKMg,9300
-chuk_tool_processor-0.1.2.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-chuk_tool_processor-0.1.2.dist-info/top_level.txt,sha256=7lTsnuRx4cOW4U2sNJWNxl4ZTt_J1ndkjTbj3pHPY5M,20
-chuk_tool_processor-0.1.2.dist-info/RECORD,,
+chuk_tool_processor-0.1.4.dist-info/METADATA,sha256=ekQNpVXyJrLw9kaLnhHW4iI1Q5do07T6Ol2QfeRsQn0,13703
+chuk_tool_processor-0.1.4.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
+chuk_tool_processor-0.1.4.dist-info/top_level.txt,sha256=7lTsnuRx4cOW4U2sNJWNxl4ZTt_J1ndkjTbj3pHPY5M,20
+chuk_tool_processor-0.1.4.dist-info/RECORD,,

{chuk_tool_processor-0.1.2.dist-info → chuk_tool_processor-0.1.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.1)
+Generator: setuptools (80.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any