feat: add mcp sample (#213)

2026-03-22 05:57:17 +08:00 · 2025-03-13 22:33:55 +08:00
parent 485fba98e2 b44d5b9604
commit 3bdc4139f6
14 changed files with 435 additions and 31 deletions
--- a/README.md
+++ b/README.md
@@ -122,7 +122,9 @@ https://private-user-images.githubusercontent.com/55657767/420212194-e813fc05-13
 - **Browser Automation**: Utilize the Playwright framework for simulating browser interactions, including scrolling, clicking, input handling, downloading, navigation, and more.
 - **Document Parsing**: Extract content from Word, Excel, PDF, and PowerPoint files, converting them into text or Markdown format.
 - **Code Execution**: Write and execute Python code using interpreter.
- **Built-in Toolkits**: Access to a comprehensive set of built-in toolkits including ArxivToolkit, AudioAnalysisToolkit, CodeExecutionToolkit, DalleToolkit, DataCommonsToolkit, ExcelToolkit, GitHubToolkit, GoogleMapsToolkit, GoogleScholarToolkit, ImageAnalysisToolkit, MathToolkit, NetworkXToolkit, NotionToolkit, OpenAPIToolkit, RedditToolkit, SearchToolkit, SemanticScholarToolkit, SymPyToolkit, VideoAnalysisToolkit, WeatherToolkit, BrowserToolkit, and many more for specialized tasks.
+- **Built-in Toolkits**: Access to a comprehensive set of built-in toolkits including:
+  - **Model Context Protocol (MCP)**: A universal protocol layer that standardizes AI model interactions with various tools and data sources
+  - **Core Toolkits**: ArxivToolkit, AudioAnalysisToolkit, CodeExecutionToolkit, DalleToolkit, DataCommonsToolkit, ExcelToolkit, GitHubToolkit, GoogleMapsToolkit, GoogleScholarToolkit, ImageAnalysisToolkit, MathToolkit, NetworkXToolkit, NotionToolkit, OpenAPIToolkit, RedditToolkit, SearchToolkit, SemanticScholarToolkit, SymPyToolkit, VideoAnalysisToolkit, WeatherToolkit, BrowserToolkit, and many more for specialized tasks

 # 🛠️ Installation

@@ -275,6 +277,23 @@ For more detailed Docker usage instructions, including cross-platform support, o

 # 🚀 Quick Start

+## Try MCP (Model Context Protocol) Integration
+
+Experience the power of MCP by running our example that demonstrates multi-agent information retrieval and processing:
+
+```bash
+# Set up MCP servers (one-time setup)
+npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
+npx @wonderwhy-er/desktop-commander setup
+
+# Run the MCP example
+python owl/run_mcp.py
+```
+
+This example showcases how OWL agents can seamlessly interact with file systems, web automation, and information retrieval through the MCP protocol. Check out `owl/run_mcp.py` for the full implementation.
+
+## Basic Usage
+
 After installation and setting up your environment variables, you can start using OWL right away:

 ```bash
@@ -358,6 +377,14 @@ Here are some tasks you can try with OWL:

 # 🧰 Toolkits and Capabilities

+## Model Context Protocol (MCP)
+
+OWL's MCP integration provides a standardized way for AI models to interact with various tools and data sources:
+
+Try our comprehensive MCP example in `owl/run_mcp.py` to see these capabilities in action!
+
+## Available Toolkits
+
 > **Important**: Effective use of toolkits requires models with strong tool calling capabilities. For multimodal toolkits (Web, Image, Video), models must also have multimodal understanding abilities.

 OWL supports various toolkits that can be customized by modifying the `tools` list in your script:
--- a/README_zh.md
+++ b/README_zh.md
@@ -105,7 +105,7 @@
 </div>

 - **[2025.03.12]**: 在SearchToolkit中添加了Bocha搜索功能，集成了火山引擎模型平台，并更新了Azure和OpenAI Compatible模型的结构化输出和工具调用能力。
- **[2025.03.11]**: 我们添加了 MCPToolkit、FileWriteToolkit 和 TerminalToolkit，增强 OWL Agent的工具调用、文件写入能力和终端命令执行功能。
+- **[2025.03.11]**: 我们添加了 MCPToolkit、FileWriteToolkit 和 TerminalToolkit，增强了 OWL Agent 的 MCP（模型上下文协议）集成、文件写入能力和终端命令执行功能。MCP 作为一个通用协议层，标准化了 AI 模型与各种数据源和工具的交互方式。
 - **[2025.03.09]**: 我们添加了基于网页的用户界面，使系统交互变得更加简便。
 - **[2025.03.07]**: 我们开源了 🦉 OWL 项目的代码库。
 - **[2025.03.03]**: OWL 在 GAIA 基准测试中取得 58.18 平均分，在开源框架中排名第一！
@@ -272,6 +272,23 @@ chmod +x build_docker.sh
 更多详细的Docker使用说明，包括跨平台支持、优化配置和故障排除，请参阅 [DOCKER_README.md](.container/DOCKER_README.md)

 # 🚀 快速开始
+
+## 尝试 MCP（模型上下文协议）集成
+
+体验 MCP 的强大功能，运行我们的示例来展示多智能体信息检索和处理：
+
+```bash
+# 设置 MCP 服务器（仅需一次性设置）
+npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
+npx @wonderwhy-er/desktop-commander setup
+
+# 运行 MCP 示例
+python owl/run_mcp.py
+```
+
+这个示例展示了 OWL 智能体如何通过 MCP 协议无缝地与文件系统、网页自动化和信息检索进行交互。查看 `owl/run_mcp.py` 了解完整实现。
+
+## 基本用法
   
 运行以下示例：

@@ -352,6 +369,14 @@ OWL 将自动调用与文档相关的工具来处理文件并提取答案。

 # 🧰 工具包与功能

+## 模型上下文协议（MCP）
+
+OWL 的 MCP 集成为 AI 模型与各种工具和数据源的交互提供了标准化的方式。
+
+查看我们的综合示例 `owl/run_mcp.py` 来体验这些功能！
+
+## 可用工具包
+
 > **重要提示**：有效使用工具包需要具备强大工具调用能力的模型。对于多模态工具包（Web、图像、视频），模型还必须具备多模态理解能力。

 OWL支持多种工具包，可通过修改脚本中的`tools`列表进行自定义：
--- a/owl/mcp_servers_config.json
+++ b/owl/mcp_servers_config.json
@@ -0,0 +1,16 @@
+{
+  "mcpServers": {
+    "desktop-commander": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@wonderwhy-er/desktop-commander"
+      ]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@executeautomation/playwright-mcp-server"]
+    }
+  }
+}
+
--- a/owl/run_deepseek_zh.py
+++ b/owl/run_deepseek_zh.py
@@ -31,7 +31,7 @@ from camel.toolkits import (
 from camel.types import ModelPlatformType, ModelType


-from utils import OwlRolePlaying, run_society, DocumentProcessingToolkit
+from utils import OwlRolePlaying, run_society

 from camel.logger import set_log_level

@@ -99,9 +99,7 @@ def construct_society(question: str) -> OwlRolePlaying:
 def main():
    r"""Main function to run the OWL system with an example question."""
    # Example research question
-    question = (
-        "搜索OWL项目最近的新闻并生成一篇报告，最后保存到本地。"
-    )
+    question = "搜索OWL项目最近的新闻并生成一篇报告，最后保存到本地。"

    # Construct and run the society
    society = construct_society(question)
--- a/owl/run_mcp.py
+++ b/owl/run_mcp.py
@@ -0,0 +1,184 @@
+# ========= 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 Multi-Agent System Example
+
+This example demonstrates how to use MCP (Model Context Protocol) with CAMEL agents
+for advanced information retrieval and processing tasks.
+
+Environment Setup:
+1. Configure the required dependencies of owl library
+   Refer to: https://github.com/camel-ai/owl for installation guide
+
+2. MCP Server Setup:
+
+   2.1 MCP Desktop Commander (File System Service):
+   Prerequisites: Node.js and npm
+   ```bash
+   # Install MCP service
+   npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
+   npx @wonderwhy-er/desktop-commander setup
+
+   # Configure in owl/mcp_servers_config.json:
+   {
+     "desktop-commander": {
+       "command": "npx",
+       "args": [
+         "-y",
+         "@wonderwhy-er/desktop-commander"
+       ]
+     }
+   }
+   ```
+
+   2.2 MCP Playwright Service:
+   ```bash
+   # Install MCP service
+   npm install -g @executeautomation/playwright-mcp-server
+   npx playwright install-deps
+
+   # Configure in mcp_servers_config.json:
+   {
+     "mcpServers": {
+       "playwright": {
+         "command": "npx",
+         "args": ["-y", "@executeautomation/playwright-mcp-server"]
+       }
+     }
+   }
+   ```
+
+   2.3 MCP Fetch Service (Optional - for better retrieval):
+   ```bash
+   # Install MCP service
+   pip install mcp-server-fetch
+
+   # Configure in mcp_servers_config.json:
+   {
+     "mcpServers": {
+       "fetch": {
+         "command": "python",
+         "args": ["-m", "mcp_server_fetch"]
+       }
+     }
+   }
+   ```
+
+Usage:
+1. Ensure all MCP servers are properly configured in mcp_servers_config.json
+2. Run this script to create a multi-agent system that can:
+   - Access and manipulate files through MCP Desktop Commander
+   - Perform web automation tasks using Playwright
+   - Process and generate information using GPT-4o
+   - Fetch web content (if fetch service is configured)
+3. The system will execute the specified task while maintaining security through
+   controlled access
+
+Note:
+- All file operations are restricted to configured directories
+- System uses GPT-4o for both user and assistant roles
+- Supports asynchronous operations for efficient processing
+"""
+
+import asyncio
+from pathlib import Path
+from typing import List
+
+from dotenv import load_dotenv
+
+from camel.models import ModelFactory
+from camel.toolkits import FunctionTool
+from camel.types import ModelPlatformType, ModelType
+from camel.logger import set_log_level
+from camel.toolkits import MCPToolkit
+
+from utils.enhanced_role_playing import OwlRolePlaying, run_society
+
+
+load_dotenv()
+set_log_level(level="DEBUG")
+
+
+async def construct_society(
+    question: str,
+    tools: List[FunctionTool],
+) -> OwlRolePlaying:
+    r"""build a multi-agent OwlRolePlaying instance.
+
+    Args:
+        question (str): The question to ask.
+        tools (List[FunctionTool]): The MCP tools to use.
+    """
+    models = {
+        "user": ModelFactory.create(
+            model_platform=ModelPlatformType.OPENAI,
+            model_type=ModelType.GPT_4O,
+            model_config_dict={"temperature": 0},
+        ),
+        "assistant": ModelFactory.create(
+            model_platform=ModelPlatformType.OPENAI,
+            model_type=ModelType.GPT_4O,
+            model_config_dict={"temperature": 0},
+        ),
+    }
+
+    user_agent_kwargs = {"model": models["user"]}
+    assistant_agent_kwargs = {
+        "model": models["assistant"],
+        "tools": tools,
+    }
+
+    task_kwargs = {
+        "task_prompt": question,
+        "with_task_specify": False,
+    }
+
+    society = OwlRolePlaying(
+        **task_kwargs,
+        user_role_name="user",
+        user_agent_kwargs=user_agent_kwargs,
+        assistant_role_name="assistant",
+        assistant_agent_kwargs=assistant_agent_kwargs,
+    )
+    return society
+
+
+async def main():
+    config_path = Path(__file__).parent / "mcp_servers_config.json"
+    mcp_toolkit = MCPToolkit(config_path=str(config_path))
+
+    try:
+        await mcp_toolkit.connect()
+
+        question = (
+            "I'd like a academic report about Andrew Ng, including his research "
+            "direction, published papers (At least 3), institutions, etc."
+            "Then organize the report in Markdown format and save it to my desktop"
+        )
+
+        # Connect to all MCP toolkits
+        tools = [*mcp_toolkit.get_tools()]
+        society = await construct_society(question, tools)
+        answer, chat_history, token_count = await run_society(society)
+        print(f"\033[94mAnswer: {answer}\033[0m")
+
+    finally:
+        # Make sure to disconnect safely after all operations are completed.
+        try:
+            await mcp_toolkit.disconnect()
+        except Exception:
+            print("Disconnect failed")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
--- a/owl/run_terminal.py
+++ b/owl/run_terminal.py
@@ -18,7 +18,7 @@ from camel.toolkits import (
    SearchToolkit,
    BrowserToolkit,
    FileWriteToolkit,
-    TerminalToolkit
+    TerminalToolkit,
 )
 from camel.types import ModelPlatformType, ModelType
 from camel.logger import set_log_level
@@ -30,6 +30,7 @@ set_log_level(level="DEBUG")
 # Get current script directory
 base_dir = os.path.dirname(os.path.abspath(__file__))

+
 def construct_society(question: str) -> OwlRolePlaying:
    r"""Construct a society of agents based on the given question.

@@ -113,7 +114,9 @@ def main():
    answer, chat_history, token_count = run_society(society)

    # Output the result
-    print(f"\033[94mAnswer: {answer}\nChat History: {chat_history}\ntoken_count:{token_count}\033[0m")
+    print(
+        f"\033[94mAnswer: {answer}\nChat History: {chat_history}\ntoken_count:{token_count}\033[0m"
+    )


 if __name__ == "__main__":
--- a/owl/run_terminal_zh.py
+++ b/owl/run_terminal_zh.py
@@ -12,13 +12,13 @@
 # limitations under the License.
 # ========= Copyright 2023-2024 @ CAMEL-AI.org. All Rights Reserved. =========
 from dotenv import load_dotenv
-
+import os
 from camel.models import ModelFactory
 from camel.toolkits import (
    SearchToolkit,
    BrowserToolkit,
    FileWriteToolkit,
-    TerminalToolkit
+    TerminalToolkit,
 )
 from camel.types import ModelPlatformType, ModelType
 from camel.logger import set_log_level
@@ -27,10 +27,12 @@ from utils import OwlRolePlaying, run_society

 load_dotenv()
 set_log_level(level="DEBUG")
-import os
+
+
 # Get current script directory
 base_dir = os.path.dirname(os.path.abspath(__file__))

+
 def construct_society(question: str) -> OwlRolePlaying:
    r"""Construct a society of agents based on the given question.

@@ -112,7 +114,9 @@ def main():
    answer, chat_history, token_count = run_society(society)

    # Output the result
-    print(f"\033[94mAnswer: {answer}\nChat History: {chat_history}\ntoken_count:{token_count}\033[0m")
+    print(
+        f"\033[94mAnswer: {answer}\nChat History: {chat_history}\ntoken_count:{token_count}\033[0m"
+    )


 if __name__ == "__main__":
--- a/owl/utils/enhanced_role_playing.py
+++ b/owl/utils/enhanced_role_playing.py
@@ -152,7 +152,7 @@ Please note that the task may be very complicated. Do not attempt to solve the t
 Here are some tips that will help you to give more valuable instructions about our task to me:
 <tips>
 - I have various tools to use, such as search toolkit, web browser simulation toolkit, document relevant toolkit, code execution toolkit, etc. Thus, You must think how human will solve the task step-by-step, and give me instructions just like that. For example, one may first use google search to get some initial information and the target url, then retrieve the content of the url, or do some web browser interaction to find the answer.
- Although the task is complex, the answer does exist. If you can’t find the answer using the current scheme, try to re-plan and use other ways to find the answer, e.g. using other tools or methods that can achieve similar results.
+- Although the task is complex, the answer does exist. If you can't find the answer using the current scheme, try to re-plan and use other ways to find the answer, e.g. using other tools or methods that can achieve similar results.
 - Always remind me to verify my final answer about the overall task. This work can be done by using multiple tools(e.g., screenshots, webpage analysis, etc.), or something else.
 - If I have written code, please remind me to run the code and get the result.
 - Search results typically do not provide precise answers. It is not likely to find the answer directly using search toolkit only, the search query should be concise and focuses on finding sources rather than direct answers, as it always need to use other tools to further process the url, e.g. interact with the webpage, extract webpage content, etc. 
@@ -281,6 +281,74 @@ Please note that our overall task may be very complicated. Here are some tips th
            ),
        )

+    async def astep(
+        self, assistant_msg: BaseMessage
+    ) -> Tuple[ChatAgentResponse, ChatAgentResponse]:
+        user_response = await self.user_agent.astep(assistant_msg)
+        if user_response.terminated or user_response.msgs is None:
+            return (
+                ChatAgentResponse(msgs=[], terminated=False, info={}),
+                ChatAgentResponse(
+                    msgs=[],
+                    terminated=user_response.terminated,
+                    info=user_response.info,
+                ),
+            )
+        user_msg = self._reduce_message_options(user_response.msgs)
+
+        modified_user_msg = deepcopy(user_msg)
+
+        if "TASK_DONE" not in user_msg.content:
+            modified_user_msg.content += f"""\n
+            Here are auxiliary information about the overall task, which may help you understand the intent of the current task:
+            <auxiliary_information>
+            {self.task_prompt}
+            </auxiliary_information>
+            If there are available tools and you want to call them, never say 'I will ...', but first call the tool and reply based on tool call's result, and tell me which tool you have called.
+            """
+
+        else:
+            # The task is done, and the assistant agent need to give the final answer about the original task
+            modified_user_msg.content += f"""\n
+            Now please make a final answer of the original task based on our conversation : <task>{self.task_prompt}</task>
+            """
+
+        assistant_response = await self.assistant_agent.astep(user_msg)
+        if assistant_response.terminated or assistant_response.msgs is None:
+            return (
+                ChatAgentResponse(
+                    msgs=[],
+                    terminated=assistant_response.terminated,
+                    info=assistant_response.info,
+                ),
+                ChatAgentResponse(
+                    msgs=[user_msg], terminated=False, info=user_response.info
+                ),
+            )
+        assistant_msg = self._reduce_message_options(assistant_response.msgs)
+
+        modified_assistant_msg = deepcopy(assistant_msg)
+        if "TASK_DONE" not in user_msg.content:
+            modified_assistant_msg.content += f"""\n
+                Provide me with the next instruction and input (if needed) based on my response and our current task: <task>{self.task_prompt}</task>
+                Before producing the final answer, please check whether I have rechecked the final answer using different toolkit as much as possible. If not, please remind me to do that.
+                If I have written codes, remind me to run the codes.
+                If you think our task is done, reply with `TASK_DONE` to end our conversation.
+            """
+
+        return (
+            ChatAgentResponse(
+                msgs=[assistant_msg],
+                terminated=assistant_response.terminated,
+                info=assistant_response.info,
+            ),
+            ChatAgentResponse(
+                msgs=[user_msg],
+                terminated=user_response.terminated,
+                info=user_response.info,
+            ),
+        )
+

 class OwlGAIARolePlaying(OwlRolePlaying):
    def __init__(self, **kwargs):
@@ -369,23 +437,23 @@ class OwlGAIARolePlaying(OwlRolePlaying):
        )


-def run_society(
-    society: RolePlaying, round_limit: int = 15
+async def run_society(
+    society: OwlRolePlaying,
+    round_limit: int = 15,
 ) -> Tuple[str, List[dict], dict]:
    overall_completion_token_count = 0
    overall_prompt_token_count = 0

    chat_history = []
    init_prompt = """
-Now please give me instructions to solve over overall task step by step. If the task requires some specific knowledge, please instruct me to use tools to complete the task.
-    """
+    Now please give me instructions to solve over overall task step by step. If the task requires some specific knowledge, please instruct me to use tools to complete the task.
+        """
    input_msg = society.init_chat(init_prompt)
    for _round in range(round_limit):
-        assistant_response, user_response = society.step(input_msg)
-        overall_completion_token_count += (
-            assistant_response.info["usage"]["completion_tokens"]
-            + user_response.info["usage"]["completion_tokens"]
-        )
+        assistant_response, user_response = await society.astep(input_msg)
+        overall_prompt_token_count += assistant_response.info["usage"][
+            "completion_tokens"
+        ]
        overall_prompt_token_count += (
            assistant_response.info["usage"]["prompt_tokens"]
            + user_response.info["usage"]["prompt_tokens"]
--- a/owl/utils/gaia.py
+++ b/owl/utils/gaia.py
@@ -191,7 +191,9 @@ class GAIABenchmark(BaseBenchmark):
            except Exception as e:
                logger.warning(e)
                # raise FileNotFoundError(f"{self.save_to} does not exist.")
-        datas = [data for data in datas if not self._check_task_completed(data["task_id"])]
+        datas = [
+            data for data in datas if not self._check_task_completed(data["task_id"])
+        ]
        logger.info(f"Number of tasks to be processed: {len(datas)}")
        # Process tasks
        for task in tqdm(datas, desc="Running"):
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,10 +21,12 @@ keywords = [
    "learning-systems"
 ]
 dependencies = [
-    "camel-ai[all]==0.2.27",
+    "camel-ai[all]==0.2.28",
    "chunkr-ai>=0.0.41",
    "docx2markdown>=0.1.1",
    "gradio>=3.50.2",
+    "mcp-simple-arxiv==0.2.2",
+    "mcp-server-fetch==2025.1.17",
 ]

 [project.urls]
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,4 @@
-camel-ai[all]==0.2.27
+camel-ai[all]==0.2.28
 chunkr-ai>=0.0.41
 docx2markdown>=0.1.1
 gradio>=3.50.2
--- a/run_app.py
+++ b/run_app.py
@@ -22,7 +22,8 @@ import os
 import sys
 from pathlib import Path

-os.environ['PYTHONIOENCODING'] = 'utf-8'
+os.environ["PYTHONIOENCODING"] = "utf-8"
+

 def main():
    """Main function to launch the OWL Intelligent Assistant Platform"""
--- a/run_app_zh.py
+++ b/run_app_zh.py
@@ -22,7 +22,8 @@ import os
 import sys
 from pathlib import Path

-os.environ['PYTHONIOENCODING'] = 'utf-8'
+os.environ["PYTHONIOENCODING"] = "utf-8"
+

 def main():
    """主函数，启动OWL智能助手运行平台"""
--- a/uv.lock
+++ b/uv.lock
@@ -482,7 +482,7 @@ wheels = [

 [[package]]
 name = "camel-ai"
-version = "0.2.27"
+version = "0.2.28"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "colorama" },
@@ -499,9 +499,9 @@ dependencies = [
    { name = "pyyaml" },
    { name = "tiktoken" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/ff/27/2bce666ae7f7d0db276d037b3afe84a460e782438e5cacc08de20417233b/camel_ai-0.2.27.tar.gz", hash = "sha256:4689245ad48f51e5e602d2651cf463afe212bcf046633a19c2189574c1f3481a", size = 441363 }
+sdist = { url = "https://files.pythonhosted.org/packages/6a/3b/7f350ae3c5bf42263688d3a69333e3908af4d45ce8f5f838af634a2720b3/camel_ai-0.2.28.tar.gz", hash = "sha256:f47e12bdf59df6e789db4587f0c5bd0adf43b2029d6be1bfcc31bfd41cab9d9f", size = 443082 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b0/fa/94f5b41cb6babc81aac00494b170ec2bea058b6c00f477ceb3e886c49177/camel_ai-0.2.27-py3-none-any.whl", hash = "sha256:c4a6597791faf2f2161c56c2579e60850557b126135b29af77ebd08fa0774e0b", size = 746387 },
+    { url = "https://files.pythonhosted.org/packages/5d/27/8a6e97f660354ce03413872268c7f4a40ceefdf39b20f161cb7f672dc67c/camel_ai-0.2.28-py3-none-any.whl", hash = "sha256:079e7e905a36b64be47a6a27ad4b99d21ca0403b27027a4d777744968a22040a", size = 748237 },
 ]

 [package.optional-dependencies]
@@ -2685,6 +2685,19 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/42/d7/1ec15b46af6af88f19b8e5ffea08fa375d433c998b8a7639e76935c14f1f/markdown_it_py-3.0.0-py3-none-any.whl", hash = "sha256:355216845c60bd96232cd8d8c40e8f9765cc86f46880e43a8fd22dc1a1a8cab1", size = 87528 },
 ]

+[[package]]
+name = "markdownify"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "six" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2f/78/c48fed23c7aebc2c16049062e72de1da3220c274de59d28c942acdc9ffb2/markdownify-1.1.0.tar.gz", hash = "sha256:449c0bbbf1401c5112379619524f33b63490a8fa479456d41de9dc9e37560ebd", size = 17127 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/64/11/b751af7ad41b254a802cf52f7bc1fca7cabe2388132f2ce60a1a6b9b9622/markdownify-1.1.0-py3-none-any.whl", hash = "sha256:32a5a08e9af02c8a6528942224c91b933b4bd2c7d078f9012943776fc313eeef", size = 13901 },
+]
+
 [[package]]
 name = "markupsafe"
 version = "2.1.5"
@@ -2806,6 +2819,38 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/d0/d2/a9e87b506b2094f5aa9becc1af5178842701b27217fa43877353da2577e3/mcp-1.3.0-py3-none-any.whl", hash = "sha256:2829d67ce339a249f803f22eba5e90385eafcac45c94b00cab6cef7e8f217211", size = 70672 },
 ]

+[[package]]
+name = "mcp-server-fetch"
+version = "2025.1.17"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdownify" },
+    { name = "mcp" },
+    { name = "protego" },
+    { name = "pydantic" },
+    { name = "readabilipy" },
+    { name = "requests" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/99/76/204ac83afe2000b1513b4741229586128361f376fab03832695e0179104d/mcp_server_fetch-2025.1.17.tar.gz", hash = "sha256:aa3a5dee358651103477bc121b98ada18a5c35840c56e4016cc3b40e7df1aa7d", size = 43468 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d7/34/c0dce3415b627f763a9b7a0202a6a0672446b49f5ca04827340c28d75c63/mcp_server_fetch-2025.1.17-py3-none-any.whl", hash = "sha256:53c4967572464c6329824c9b05cdfa5fe214004d577ae8700fdb04203844be52", size = 7991 },
+]
+
+[[package]]
+name = "mcp-simple-arxiv"
+version = "0.2.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "feedparser" },
+    { name = "httpx" },
+    { name = "mcp" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/20/d3/d47bfce067ea85bc73154d8299549f84455e601f699fcff513f9d44cef0d/mcp_simple_arxiv-0.2.2.tar.gz", hash = "sha256:e27cfd58a470dcec7d733bd09b4219daddbdc3475a6d256e246a114e5b94e817", size = 12100 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/07/4e/6646a0004fc85b0c1df6e662db42f76fe5a0412179b7f65c066d7804370a/mcp_simple_arxiv-0.2.2-py3-none-any.whl", hash = "sha256:fcf607303c074ae5e88337b5bf3ea52cd781081f49ddf8fa0898eb3b8420dccb", size = 13686 },
+]
+
 [[package]]
 name = "mdurl"
 version = "0.1.2"
@@ -3571,14 +3616,18 @@ dependencies = [
    { name = "chunkr-ai" },
    { name = "docx2markdown" },
    { name = "gradio" },
+    { name = "mcp-server-fetch" },
+    { name = "mcp-simple-arxiv" },
 ]

 [package.metadata]
 requires-dist = [
-    { name = "camel-ai", extras = ["all"], specifier = "==0.2.27" },
+    { name = "camel-ai", extras = ["all"], specifier = "==0.2.28" },
    { name = "chunkr-ai", specifier = ">=0.0.41" },
    { name = "docx2markdown", specifier = ">=0.1.1" },
    { name = "gradio", specifier = ">=3.50.2" },
+    { name = "mcp-server-fetch", specifier = "==2025.1.17" },
+    { name = "mcp-simple-arxiv", specifier = "==0.2.2" },
 ]

 [[package]]
@@ -3962,6 +4011,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/b5/35/6c4c6fc8774a9e3629cd750dc24a7a4fb090a25ccd5c3246d127b70f9e22/propcache-0.3.0-py3-none-any.whl", hash = "sha256:67dda3c7325691c2081510e92c561f465ba61b975f481735aefdfc845d2cd043", size = 12101 },
 ]

+[[package]]
+name = "protego"
+version = "0.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/4e/6b/84e878d0567dfc11538bad6ce2595cee7ae0c47cf6bf7293683c9ec78ef8/protego-0.4.0.tar.gz", hash = "sha256:93a5e662b61399a0e1f208a324f2c6ea95b23ee39e6cbf2c96246da4a656c2f6", size = 3246425 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d9/fd/8d84d75832b0983cecf3aff7ae48362fe96fc8ab6ebca9dcf3cefd87e79c/Protego-0.4.0-py2.py3-none-any.whl", hash = "sha256:37640bc0ebe37572d624453a21381d05e9d86e44f89ff1e81794d185a0491666", size = 8553 },
+]
+
 [[package]]
 name = "proto-plus"
 version = "1.26.0"
@@ -4673,6 +4731,21 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/09/f6/fa777f336629aee8938f3d5c95c09df38459d4eadbdbe34642889857fb6a/rapidfuzz-3.12.2-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:54bb69ebe5ca0bd7527357e348f16a4c0c52fe0c2fcc8a041010467dcb8385f7", size = 1555000 },
 ]

+[[package]]
+name = "readabilipy"
+version = "0.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "beautifulsoup4" },
+    { name = "html5lib" },
+    { name = "lxml" },
+    { name = "regex" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b8/e4/260a202516886c2e0cc6e6ae96d1f491792d829098886d9529a2439fbe8e/readabilipy-0.3.0.tar.gz", hash = "sha256:e13313771216953935ac031db4234bdb9725413534bfb3c19dbd6caab0887ae0", size = 35491 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dd/46/8a640c6de1a6c6af971f858b2fb178ca5e1db91f223d8ba5f40efe1491e5/readabilipy-0.3.0-py3-none-any.whl", hash = "sha256:d106da0fad11d5fdfcde21f5c5385556bfa8ff0258483037d39ea6b1d6db3943", size = 22158 },
+]
+
 [[package]]
 name = "redis"
 version = "5.2.1"