使用说明

项目简介

Nerve (神经) 是一个 Agent Development Kit (ADK)，旨在简化基于LLM的智能体的开发。除了作为ADK，Nerve 还可以作为 MCP (Model Context Protocol) 服务器运行，将其配置的 Agent 和工具以标准化的 MCP 协议对外提供服务。

主要功能点

LLM Agent 运行平台: Nerve 可以加载和运行基于 YAML 文件配置的 LLM Agent。
MCP 服务器功能: 将 Agent 的核心能力（如 Agent 自身功能和各种工具）通过 MCP 协议以 SSE (Server-Sent Events) 等传输方式暴露给客户端。
工具集成: 内置丰富的工具集 (namespaces) ，并支持自定义工具和集成外部 MCP 服务器的工具。
REST API 支持: 除了 MCP 服务，Nerve 也可以将 Agent 作为 REST API 服务提供。

安装步骤

使用 pip 安装 nerve-adk 包：

pip install nerve-adk

服务器配置

为了让 MCP 客户端连接到 Nerve MCP 服务器，客户端需要配置服务器连接信息。以下是一个典型的 MCP 客户端配置示例 (JSON 格式)：

{
  "server_name": "nerve_agent_server",
  "command": "nerve",
  "args": ["serve", "path/to/your/agent.yml", "--mcp-sse"]
}

配置参数说明：

'server_name': 为你的 Nerve MCP 服务器实例指定一个名称，可以自定义。
'command': 启动 Nerve MCP 服务器的命令，通常为 'nerve'。
'args': 传递给 'nerve serve' 命令的参数：
- '"serve"': 指定 Nerve CLI 运行 serve 命令，启动服务器。
- '"path/to/your/agent.yml"': 请替换为你的 Agent 配置文件（YAML 文件）的实际路径。此配置文件定义了 Agent 的行为和能力。
- '"--mcp-sse"': 启用 MCP 服务器的 SSE 传输模式。这是推荐的模式，确保客户端与服务器通过 SSE 协议通信。你也可以使用 '"--mcp"' 参数启用 stdio 传输模式，如果客户端支持的话。

基本使用方法

准备 Agent 配置文件: 首先需要创建一个 YAML 格式的 Agent 配置文件，定义 Agent 的系统提示 (agent)、任务描述 (task)、使用的工具 (using/tools) 等。可以参考 Nerve 仓库 examples 目录下的示例。
启动 Nerve MCP 服务器: 在安装 Nerve 和配置好 Agent 文件后，使用配置信息中的 'command' 和 'args' 在命令行启动 Nerve MCP 服务器。例如，根据上述配置，在命令行执行：
```
nerve serve path/to/your/agent.yml --mcp-sse
```
配置和连接 MCP 客户端: 在 MCP 客户端中，配置连接到 Nerve MCP 服务器所需的信息，主要是服务器的启动命令 ('command' 和 'args')。启动客户端后，客户端即可通过 MCP 协议与 Nerve 服务器建立连接，并调用 Agent 提供的功能。

注意: 'path/to/your/agent.yml' 需要替换成实际的 Agent 配置文件路径。确保 MCP 客户端能够访问到 Nerve 服务器运行的网络环境。

关键词