Skip to content

armgit / camel

Public Imported from GitHub
0

🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

5.5 KB
Raw Blame
# ========= Copyright 2023-2026 @ 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-2026 @ CAMEL-AI.org. All Rights Reserved. =========
from typing import Any, Dict, Optional

from mcp.server.fastmcp import Context, FastMCP

from camel.utils import model_from_json_schema
from services.agent_mcp.agent_config import agents_dict, description_dict

mcp = FastMCP("ChatAgentMCP", dependencies=["camel-ai[all]"])


@mcp.tool()
async def step(
    name: str,
    message: str,
    ctx: Context,
    response_format: Optional[Dict[str, Any]] = None,
) -> Dict[str, Any]:
    r"""Execute a single step in the chat session with the agent.

    Args:
        name (str): The name of the agent to use.
        message (str): The input message for the agent.
        ctx (Context): The context object for the tool.
        response_format (Optional[Dict[str, Any]]): Optional schema for
            structured response. (default: :obj:`None`)

    Returns:
        Dict[str, Any]: A dictionary containing the response from the agent.
    """
    try:
        agent = agents_dict[name]
    except KeyError:
        return {
            "status": "error",
            "message": f"Agent with name {name} not found",
        }

    format_cls = None
    if response_format:
        format_cls = model_from_json_schema(
            "DynamicResponseFormat", response_format
        )

    await ctx.info(f"The agent {name} is processing the message: {message}")
    response = await agent.astep(message, format_cls)

    return {
        "status": "success",
        "messages": [msg.to_dict() for msg in response.msgs],
        "terminated": response.terminated,
        "info": response.info,
    }


@mcp.tool()
async def reset(ctx: Context) -> Dict[str, str]:
    r"""Reset the chat agent to its initial state.

    Args:
        ctx (Context): The context object for the tool.

    Returns:
        Dict[str, str]: A dictionary containing the status of the reset
            operation.
    """
    for agent in agents_dict.values():
        agent.reset()
    await ctx.info("All agents reset successfully")
    return {"status": "success", "message": "All agents reset successfully"}


@mcp.tool()
async def set_output_language(language: str, ctx: Context) -> Dict[str, str]:
    r"""Set the output language for the chat agent.

    Args:
        language (str): The language to set the output language to.
        ctx (Context): The context object for the tool.

    Returns:
        Dict[str, str]: A dictionary containing the status of the language
            setting operation
    """
    for agent in agents_dict.values():
        agent.output_language = language
    await ctx.info(f"Output language set to '{language}'")
    return {
        "status": "success",
        "message": f"Output language set to '{language}'",
    }


@mcp.resource("agent://")
@mcp.tool()
def get_agents_info() -> Dict[str, Any]:
    r"""Get information about all agents provided by the server.

    Returns:
        Dict[str, Any]: A dictionary containing information about all agents.
    """
    return description_dict


@mcp.resource("history://{name}")
@mcp.tool()
def get_chat_history(name: str) -> Dict[str, Any]:
    r"""Get the chat history for the given agent.

    Args:
        name (str): The name of the agent to get the chat history for.

    Returns:
        Dict[str, Any]: A dictionary containing the chat history for the
            given agent.
    """
    try:
        agent = agents_dict[name]
    except KeyError:
        return {
            "status": "error",
            "message": f"Agent with name {name} not found",
        }
    return {
        "status": "success",
        "chat_history": agent.chat_history,
    }


@mcp.resource("agent://{name}")
@mcp.tool()
def get_agent_info(name: str) -> Dict[str, Any]:
    r"""Get information about the given agent.

    Args:
        name (str): The name of the agent to get information for.

    Returns:
        Dict[str, Any]: A dictionary containing information about the given
            agent.
    """
    try:
        agent = agents_dict[name]
    except KeyError:
        return {
            "status": "error",
            "message": f"Agent with name {name} not found",
        }
    info = {
        "agent_id": agent.agent_id,
        "model_type": str(agent.model_type),
        "output_language": agent.output_language,
        "description": description_dict[name],
    }
    return info


@mcp.resource("tool://{name}")
@mcp.tool()
def get_available_tools(name: str) -> Dict[str, Any]:
    r"""Get a list of available internal tools.

    Args:
        name (str): The name of the agent to get the available tools for.

    Returns:
        Dict[str, Any]: A dictionary containing the available internal tools.
    """
    try:
        agent = agents_dict[name]
    except KeyError:
        return {
            "status": "error",
            "message": f"Agent with name {name} not found",
        }
    return agent.tool_dict


if __name__ == "__main__":
    mcp.run(transport='stdio')