使用说明

项目简介

'unifai-sdk-py' 提供的 Unifai 工具 MCP 服务器，旨在将 Unifai 平台的强大动态工具集成到任何支持 Model Context Protocol (MCP) 的 LLM 客户端，例如 Claude Desktop。通过此服务器，LLM 应用可以安全、标准地访问和调用 Unifai 托管的各种工具，扩展 LLM 的能力边界。

主要功能点

工具发现与注册：自动将 Unifai 平台上的可用工具以 MCP 协议标准格式暴露给客户端。
工具调用执行：接收并处理来自 MCP 客户端的工具调用请求，执行相应的 Unifai 工具，并将结果返回客户端。
标准化接口：遵循 MCP 协议，使用 JSON-RPC 通信，保证与各种 MCP 客户端的兼容性。
易于部署：使用 Python 开发，可以通过简单的命令启动和配置。

安装步骤

确保已安装 Python 环境。

使用 pip 安装 'unifai-sdk':

pip install unifai-sdk

服务器配置 (Claude Desktop 示例)

以下是在 Claude Desktop 中配置 Unifai 工具 MCP 服务器的 JSON 示例。您需要将这段配置添加到 Claude Desktop 的配置文件中。

{
  "mcpServers": {
    "unifai-tools": {
      "command": "uvx",
      "args": [
        "--from",
        "unifai-sdk",
        "unifai-tools-mcp"
      ],
      "env": {
        "UNIFAI_AGENT_API_KEY": "YOUR_UNIFAI_AGENT_API_KEY"
      }
    }
  }
}

配置项说明:

'server name': 'unifai-tools' (服务器名称，在 Claude Desktop 中自定义，用于标识该 MCP 服务器)
'command': 'uvx' (启动服务器的命令。这里 'uvx' 是 'uv' 包管理器提供的执行包内模块的命令，假设您已安装 'uv' 并将其加入到环境变量。)
'args': 启动命令的参数列表。
- '--from unifai-sdk': 指示 'uvx' 从 'unifai-sdk' Python 包中查找可执行模块。
- 'unifai-tools-mcp': 指定要执行的模块入口点，即 'unifai-sdk' 包中的 'unifai.tools.mcp.main' 模块。
'env': 环境变量配置。
- 'UNIFAI_AGENT_API_KEY': (必填) 您的 Unifai Agent API 密钥。您需要前往 Unifai 官网免费获取 Agent API 密钥并替换 'YOUR_UNIFAI_AGENT_API_KEY'。

基本使用方法

获取 API 密钥：访问 Unifai 官网注册并获取 Agent API 密钥。
配置 MCP 客户端：根据您的 MCP 客户端 (如 Claude Desktop) 的文档，添加上述服务器配置，并填入您的 Unifai Agent API 密钥。
启动 MCP 客户端：启动您的 MCP 客户端，它应该能够自动连接到 Unifai 工具 MCP 服务器。
体验工具：在 MCP 客户端中与 LLM 对话，当 LLM 需要使用工具时，即可自动调用 Unifai 提供的工具来辅助完成任务。

配置完成后，您的 MCP 客户端即可利用 Unifai 平台提供的各种工具，扩展 LLM 的功能。

关键词