MCPAgentAI 使用说明

项目简介

MCPAgentAI 是一个基于 Model Context Protocol (MCP) 构建的工具包装框架，旨在简化工具集成和管理，为 LLM 应用提供标准化的工具调用服务。它内置了多种实用工具，如时间查询、天气预报、股票信息、ElizaOS 智能体集成和 Twitter 管理等，方便开发者快速构建和部署工具型应用。

主要功能点

标准化的工具封装: 基于 MCP 协议，提供统一的工具接口和调用方式。
灵活的工具扩展: 支持轻松添加或移除工具，满足不同的应用需求。
开箱即用的工具: 内置多种常用工具，包括：
- 时间工具
- 天气预报工具
- 股票数据查询工具
- 货币汇率转换工具
- 字典查询工具
- 计算器工具
- Twitter 管理工具 (发推、回复等)
- ElizaOS 智能体集成
本地及 Docker 部署: 支持本地 Python 环境运行和 Docker 容器化部署。

安装步骤

确保已安装 Python 环境。

使用 pip 命令安装 MCPAgentAI：

pip install mcpagentai

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数，以便连接到 MCPAgentAI 服务器。以下是一个典型的 JSON 格式配置示例：

{
    "mcpServers": {
        "mcpagentai": {
            "command": "mcpagentai",
            "args": []
        }
    }
}

参数注释:

'command': MCP 服务器的启动命令。这里设置为 'mcpagentai'，这是在安装 'mcpagentai' 包后可直接在命令行中使用的命令。
'args': 启动命令的参数列表。在上述配置中，'args' 为空数组 '[]'，表示启动 'mcpagentai' 服务器时不需要任何额外的命令行参数。

可选参数:

如果需要指定服务器运行的本地时区，可以在 'args' 中添加 '--local-timezone' 参数，例如：

{
    "mcpServers": {
        "mcpagentai": {
            "command": "mcpagentai",
            "args": ["--local-timezone", "America/New_York"]
        }
    }
}

将服务器时区设置为 "America/New_York"。

基本使用方法

启动 MCPAgentAI 服务器：在安装 MCPAgentAI 的 Python 环境中，打开终端并运行命令 'mcpagentai'。
配置 MCP 客户端：将上述服务器配置信息填入 MCP 客户端的相应配置项中，确保客户端能够连接到 MCPAgentAI 服务器。
调用工具：通过 MCP 客户端，可以向 MCPAgentAI 服务器发送 JSON-RPC 请求，调用服务器提供的各种工具。例如，可以调用 'get_current_time' 工具查询当前时间，或调用 'get_weather_forecast' 工具获取天气预报。
查看工具列表：客户端可以通过调用 MCP 协议的 'list_tools' 方法，查询 MCPAgentAI 服务器当前支持的所有工具及其详细信息。

更多详细使用方法和工具参数，请参考 MCPAgentAI GitHub 仓库的文档和示例。

关键词