Release v0.1.1: Fix executable name and update configuration

- Change executable name from camel-terminal-mcp to terminal-toolkit-mcp
- Update README.md with new executable name
- Update examples to use simplified configuration
- Fix MCP client configuration to work with uvx terminal-toolkit-mcp

Author: MuggleJinx

README.md

@@ -36,7 +36,7 @@ pip install -e .
 Start the server with stdio transport:
 
 ```bash
-camel-terminal-mcp
+terminal-toolkit-mcp
 ```
 
 ### Command Line Options
@@ -51,10 +51,10 @@ camel-terminal-mcp
 
 ```bash
 # Start with custom working directory and increased timeout
-camel-terminal-mcp --working-directory /tmp/workspace --timeout 60.0
+terminal-toolkit-mcp --working-directory /tmp/workspace --timeout 60.0
 
 # Start with safe mode disabled (not recommended)
-camel-terminal-mcp --no-safe-mode
+terminal-toolkit-mcp --no-safe-mode
 ```
 
 ## Available Tools

examples/camel-client.py

@@ -0,0 +1,95 @@
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
+"""MCP Server Example
+
+This example demonstrates how to use the MCP (Managed Code Processing) server
+with CAMEL agents for file operations.
+
+Setup:
+1. Install Node.js and npm
+
+2. Install MCP filesystem server globally:
+   ```bash
+   npm install -g @modelcontextprotocol/server-filesystem
+   ```
+
+Usage:
+1. Run this script to start an MCP filesystem server
+2. The server will only operate within the specified directory
+3. All paths in responses will be relative to maintain privacy
+"""
+
+import asyncio
+from pathlib import Path
+
+from camel.agents import ChatAgent
+from camel.models import ModelFactory
+from camel.toolkits import MCPToolkit
+from camel.types import ModelPlatformType, ModelType
+from camel.utils.mcp_client import MCPClient
+
+
+async def mcp_client_example():
+    config = {
+        "command": "uvx",
+        "args": ["terminal-toolkit-mcp"],
+    }
+    async with MCPClient(config) as client:
+        mcp_tools = await client.list_mcp_tools()
+        print("Available MCP tools:", [tool.name for tool in mcp_tools.tools])
+        # Use shell_exec to list directory contents instead
+        call_tool_result = await client.call_tool(
+            "shell_exec", {"id": "main", "command": "ls -la"}
+        )
+        print("Directory Contents:")
+        print(call_tool_result.content[0].text)
+
+
+
+
+
+async def mcp_toolkit_example():
+    # Use either config path or config dict to initialize the MCP toolkit.
+    # 1. Use config path:
+    config = {
+        "mcpServers": {
+            "terminal-toolkit-mcp": {
+                "command": "uvx",
+                "args": ["terminal-toolkit-mcp"],
+            }
+        }
+    }
+
+    # Connect to all MCP servers.
+    async with MCPToolkit(config=config) as mcp_toolkit:
+        sys_msg = "You are a helpful assistant"
+        model = ModelFactory.create(
+            model_platform=ModelPlatformType.DEFAULT,
+            model_type=ModelType.DEFAULT,
+        )
+        camel_agent = ChatAgent(
+            system_message=sys_msg,
+            model=model,
+            tools=[*mcp_toolkit.get_tools()],
+        )
+        user_msg = "Use terminal-toolkit-mcp to list 5 files in the project, using relative paths"
+        response = await camel_agent.astep(user_msg)
+        print(response.msgs[0].content)
+        print(response.info['tool_calls'])
+
+
+if __name__ == "__main__":
+    asyncio.run(mcp_client_example())
+    # asyncio.run(mcp_toolkit_example())
+

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "terminal-toolkit-mcp"
-version = "0.1.0"
+version = "0.1.1"
 description = "CAMEL Terminal Toolkit as a standalone MCP server"
 authors = [
     {name = "CAMEL-AI.org", email = "[email protected]"}
@@ -45,7 +45,7 @@ dev = [
 ]
 
 [project.scripts]
-camel-terminal-mcp = "camel_terminal_toolkit.server:main"
+terminal-toolkit-mcp = "camel_terminal_toolkit.server:main"
 
 [project.urls]
 Homepage = "https://github.com/camel-ai/terminal-toolkit-mcp"